Swagger Petstore - OpenAPI 3.0
POST/containers

Create a container

Creates a new container with optional configuration for files, skills, memory limits, and network policies. Supply a name at minimum — all other fields are optional. Returns the created container object with its unique identifier and current status.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 body fields

Container creation parameters. Only name is required.

namestringrequired
Name of the container to create.
file_idsarray<string>optional
IDs of files to copy to the container.
expires_afterobjectoptional
Container expiration time in seconds relative to the 'anchor' time.
skillsarray<object>optional
An optional list of skills referenced by id or inline data.
memory_limitstringoptional
Optional memory limit for the container. Defaults to "1g".
Allowed:1g4g16g64g
network_policyobjectoptional
Network access policy for the container.

2 status codes
200Returns the created container object with its unique identifier, name, creation timestamp, status, memory limit, and network policy.
idstringrequired
Unique identifier for the container.
objectstringrequired
The type of this object.
namestringrequired
Name of the container.
created_atintegerrequired
Unix timestamp (in seconds) when the container was created.
statusstringrequired
Status of the container (e.g., active, deleted).
last_active_atintegeroptional
Unix timestamp (in seconds) when the container was last active.
expires_afterobjectoptional
The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.
memory_limitstringoptional
The memory limit configured for the container.
Allowed:1g4g16g64g
network_policyobjectoptional
Network access policy for the container.
429Returned when the request exceeds the rate limit.
errorobjectrequired

Error handling

A 429 is returned when the request exceeds the rate limit. name is required and must be a non-empty string. memory_limit must be one of: 1g, 4g, 16g, or 64g, defaulting to 1g. expires_after requires both anchor (currently only last_active_at is supported) and minutes (a positive integer).