List Models changedapi/beta/models/list
Nearest release: v2.1.294, published 4 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+43added
Lines−0removed
From line
21
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits22to this page, all time
The whole hunk
from line 21, old and new numbered
/
from line 21
2121
2222 ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
2323
24- `lifecycle: optional array of "active" or "deprecated" or "retired"`
25
26 Filter the list to models in any of the given lifecycle stages (`active`, `deprecated`, or `retired`). Up to 3 values. When omitted, the list contains the `active` and `deprecated` models; `retired` models appear only when `retired` is requested explicitly.
27
28 maxItems: 3
29
30 - `"active"`
31
32 - `"deprecated"`
33
34 - `"retired"`
35
2436- `limit: optional number`
2537
2638 Number of items to return per page.
from line 313
301313
302314 format: date-time
303315
316 - `deprecated_at: string or null`
317
318 RFC 3339 datetime string representing the time of the model's most recent deprecation. Populated for `deprecated` and `retired` models; `null` while the model is `active`.
319
320 format: date-time
321
304322 - `display_name: string`
305323
306324 A human-readable name for the model.
307325
326 - `lifecycle: "active" or "deprecated" or "retired"`
327
328 The model's current lifecycle stage.
329
330 - `active`: The model is available for use, open to new adopters, and not scheduled for retirement.
331 - `deprecated`: The model remains callable for organizations with existing access, but is headed for retirement and closed to new adopters.
332 - `retired`: The model is no longer available for use; inference requests naming it fail. It remains in the catalogue as the historical record of its retirement.
333
334 default: active
335
336 - `"active"`
337
338 - `"deprecated"`
339
340 - `"retired"`
341
308342 - `line: BetaModelLine or null`
309343
310344 The model line this model belongs to, such as `opus` for both Claude Opus 4.5 and Claude Opus 4.6. More lines may be added. `null` when the model belongs to no line; do not infer a line from the `id`.
from line 361
327361
328362 Maximum value for the `max_tokens` parameter when using this model.
329363
364 - `retires_at: string or null`
365
366 RFC 3339 datetime string representing the model's currently scheduled retirement date. The schedule can be revised until retirement occurs; `null` while the model is `active` or while no retirement is scheduled. A past date on a `deprecated` model means retirement is overdue, not that it has occurred: `lifecycle` is the retirement signal.
367
368 format: date-time
369
330370- `first_id: string or null`
331371
332372 First ID in the `data` list. Can be used as the `before_id` for the previous page.
from line 477
437477 }
438478 },
439479 "created_at": "2026-07-24T00:00:00Z",
480 "deprecated_at": "2019-12-27T18:11:19.117Z",
440481 "display_name": "Claude Opus 5",
482 "lifecycle": "active",
441483 "line": "haiku",
442484 "max_input_tokens": 0,
443485 "max_tokens": 0,
486 "retires_at": "2019-12-27T18:11:19.117Z",
444487 "type": "model"
445488 }
446489 ],
No line in this hunk matches that.