For the complete documentation index, see llms.txt. This page is also available as Markdown.

Containers

Container management endpoints.

List containers

get

List containers owned by the authenticated project.

Authorizations
AuthorizationstringRequired

API key in Authorization header using Bearer .

Query parameters
limitinteger · min: 1 · max: 100OptionalDefault: 20
offsetintegerOptionalDefault: 0
Responses
200

Successful Response

application/json
objectconst: listOptional

Object type identifier.

Default: list
totalintegerRequired

Total number of items available for this resource.

get/v1/containers

Create a container

post

Create a new container. Containers represent one task in your codebase. Each container utilizes separate models, routing, and evaluations, and collects data separately.

Authorizations
AuthorizationstringRequired

API key in Authorization header using Bearer .

Body
labelstringRequired

Container label.

initial_modelstringRequired

Initial model slug.

apistring · enumOptional

API type.

Default: chat.completionsPossible values:
default_system_promptstring · nullableOptional

Default system prompt.

Responses
201

Successful Response

application/json
idstringRequired

Container id.

objectconst: containerOptional

Object type.

Default: container
org_idstring · nullableOptional

Organization id.

created_atstring · date-time · nullableOptional

Creation timestamp.

labelstringRequired

Container label.

apistring · enumOptional

API type.

Default: chat.completionsPossible values:
default_system_promptstring · nullableOptional

Default system prompt.

optimized_system_promptstring · nullableOptional

Optimized system prompt.

system_prompt_prefixstring · nullableOptional

GEPA-optimized prefix prepended to every request's system prompt.

initial_modelstring · nullableOptional

Initial model slug.

deleted_atbooleanOptional

Soft delete flag.

Default: false
post/v1/containers

Get a container

get

Fetch a single container by label within the authenticated project.

Authorizations
AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters
labelstringRequired
Responses
200

Successful Response

application/json
idstringRequired

Container id.

objectconst: containerOptional

Object type.

Default: container
org_idstring · nullableOptional

Organization id.

created_atstring · date-time · nullableOptional

Creation timestamp.

labelstringRequired

Container label.

apistring · enumOptional

API type.

Default: chat.completionsPossible values:
default_system_promptstring · nullableOptional

Default system prompt.

optimized_system_promptstring · nullableOptional

Optimized system prompt.

system_prompt_prefixstring · nullableOptional

GEPA-optimized prefix prepended to every request's system prompt.

initial_modelstring · nullableOptional

Initial model slug.

deleted_atbooleanOptional

Soft delete flag.

Default: false
get/v1/containers/{label}

Delete a container

delete

Soft-delete a container by label within the authenticated project.

Authorizations
AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters
labelstringRequired
Responses
200

Successful Response

application/json
objectconst: containerOptional

Object type.

Default: container
labelstringRequired

Container label.

deletedconst: Optional

Deletion status.

Default: true
delete/v1/containers/{label}

Update a container

patch

Update container defaults by label within the authenticated project.

Authorizations
AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters
labelstringRequired
Body

Patchable fields for a container.

default_system_promptstring · nullableOptional

Updated system prompt.

default_modelstring · min: 1 · nullableOptional

Updated default model id or slug.

Example: file_abc123
Responses
200

Successful Response

application/json
idstringRequired

Container id.

objectconst: containerOptional

Object type.

Default: container
org_idstring · nullableOptional

Organization id.

created_atstring · date-time · nullableOptional

Creation timestamp.

labelstringRequired

Container label.

apistring · enumOptional

API type.

Default: chat.completionsPossible values:
default_system_promptstring · nullableOptional

Default system prompt.

optimized_system_promptstring · nullableOptional

Optimized system prompt.

system_prompt_prefixstring · nullableOptional

GEPA-optimized prefix prepended to every request's system prompt.

initial_modelstring · nullableOptional

Initial model slug.

deleted_atbooleanOptional

Soft delete flag.

Default: false
patch/v1/containers/{label}

Add a model to a container

post

Attach a model to a container as a submodel with optional defaults.

Authorizations
AuthorizationstringRequired

API key in Authorization header using Bearer .

Body
modelstringRequired

Model slug or id to add.

containerstringRequired

Container id or label.

slugstringRequired

User specified submodel slug.

default_system_promptstring · nullableOptional

Default system prompt.

Responses
200

Successful Response

application/json
objectconst: modelOptional

Object type.

Default: model
idstringRequired

Model id.

container_idstringRequired

Container id.

slugstringRequired

Submodel slug.

containerstringRequired

Container label.

default_system_promptstring · nullableOptional

Default system prompt.

post/v1/models

Last updated