Clatter LabsHelp Center

What does 410 model_retired mean?

TroubleshootingUpdated

You called a Line Code id. Line Code was retired on Nov 1, 2026, and its ids answer 410. They are never billed and never routed to another model.

Code: model_retired · HTTP status: 410

The body includes "replacement": "supercosmos" and "retired_at": "2026-11-01".

Common causes#

  • line-code, line-code-fast, line-code-ultra or line-code-ultra-fast in your code

How to fix it#

  1. Use supercosmos-flash instead of line-code-fast.
  2. Use supercosmos-max instead of line-code-ultra.
  3. Use supercosmos-heavy instead of line-code-ultra-fast.

Should my code retry?#

Never retry: the ids won't come back.

The error body uses the OpenAI shape, so OpenAI SDKs raise it as an exception you can catch:

{"error": {"message": "...", "type": "...", "code": "model_retired", "param": null}}

Every response also carries an X-Request-Id. Keep it in your logs; it's the quickest way for support to find a request.

The full 410 response#

{
  "error": {
    "message": "Line Code was retired on Nov 1, 2026. Use SuperCosmos instead: supercosmos-flash, supercosmos-max or supercosmos-heavy (in Line CLI: /model supercosmos). See https://www.clatterlabs.com/blog/retiring-line-code-and-what-comes-next",
    "type": "invalid_request_error",
    "code": "model_retired",
    "param": "model",
    "replacement": "supercosmos",
    "retired_at": "2026-11-01"
  }
}

The family id line-code answers the same way, and GET /v1/models/line-code-fast (or any Line Code id) answers 410 too. Read why in Why was Line Code retired?.

See the full list in the Model API reference.

Still need help?#

We usually reply within the first hour, and always within 24 hours. A full support team is with you.

Related articles

Still need help?

Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.

Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyz
For deleting your whole account or the data of one service.