Sample - OpenAI API
GET/containers

List containers

Lists containers available to the authenticated user, optionally filtered by name. Use limit, after, and order to control cursor-based pagination and result ordering. The response indicates whether additional containers are available.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 parameters
limitintegeroptional
Maximum number of containers to return, from 1 to 100. Defaults to 20 when omitted.
Default:20
orderstringoptional
Sort order by creation time: `asc` for ascending or `desc` for descending. Defaults to desc when omitted.
Allowed:ascdescDefault:desc
afterstringoptional
Cursor identifying the container after which to continue listing results.
namestringoptional
Filter results to containers with the specified name.

2 status codes
200Returns a list object containing container records, the IDs of the first and last containers, and a `has_more` flag indicating whether more results are available.
objectstringrequired
The type of object returned, must be 'list'.
Allowed:list
dataarray<TheContainerObject>required
A list of containers.
first_idstringrequired
The ID of the first container in the list.
last_idstringrequired
The ID of the last container in the list.
has_morebooleanrequired
Whether there are more containers available.
429Returned when the request rate exceeds the permitted limit.
errorobjectrequired

Error handling

limit must be between 1 and 100, and order must be either asc or desc. Use after as the ID of the last container from the previous page to continue pagination. A 429 is returned when the request rate exceeds the permitted limit.