GET/containers

List containers

Lists containers available to the authenticated user. Filter the results by name and use after to continue from a container ID returned in a previous page. Results are ordered by creation time, descending by default.

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` or `desc`. Defaults to `desc` when omitted.
Allowed:ascdescDefault:desc
afterstringoptional
Container ID cursor that marks where to continue listing from the previous page.
namestringoptional
Filter the results by container name.

3 status codes
200Returns a list of containers with the first and last container IDs and a `has_more` value 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.
404Returned when the container specified by the `after` cursor is not found.
errorobjectrequired
429Returned when the request exceeds a rate limit.
errorobjectrequired

Error handling

A 404 is returned when the container identified by the after cursor is not found. A 429 is returned when the request exceeds a rate limit. limit must be between 1 and 100, and order must be asc or desc.