Containers

Container management endpoints.

List containers

get

List containers owned by the authenticated project.

Authorizations

ApiKeyAuth

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.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

get

/v1/containers

HTTPcURLJavaScriptPython

GET /v1/containers HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "text",
      "object": "container",
      "project_id": "text",
      "org_id": "text",
      "user_id": "text",
      "created_at": "2026-03-19T19:29:06.764Z",
      "label": "text",
      "api": "chat.completions",
      "best_model_id": "text",
      "default_system_prompt": "text",
      "default_parameters": {
        "provider": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "plugins": [],
        "route": "text",
        "session_id": "text",
        "frequency_penalty": 1,
        "logit_bias": {
          "ANY_ADDITIONAL_PROPERTY": 1
        },
        "logprobs": true,
        "top_logprobs": 1,
        "max_completion_tokens": 1,
        "max_tokens": 1,
        "presence_penalty": 1,
        "reasoning": {
          "effort": "none",
          "summary": "auto"
        },
        "response_format": {
          "type": "text"
        },
        "seed": 1,
        "stop": "text",
        "temperature": 1,
        "tool_choice": "none",
        "tools": [
          {
            "type": "function",
            "function": {
              "name": "text",
              "description": "text",
              "parameters": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              },
              "strict": true
            }
          }
        ],
        "top_p": 1,
        "image_config": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "modalities": [
          "text"
        ],
        "bad_words": [
          "text"
        ]
      },
      "optimized_system_prompt": "text",
      "optimized_parameters": {
        "provider": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "plugins": [],
        "route": "text",
        "session_id": "text",
        "frequency_penalty": 1,
        "logit_bias": {
          "ANY_ADDITIONAL_PROPERTY": 1
        },
        "logprobs": true,
        "top_logprobs": 1,
        "max_completion_tokens": 1,
        "max_tokens": 1,
        "presence_penalty": 1,
        "reasoning": {
          "effort": "none",
          "summary": "auto"
        },
        "response_format": {
          "type": "text"
        },
        "seed": 1,
        "stop": "text",
        "temperature": 1,
        "tool_choice": "none",
        "tools": [
          {
            "type": "function",
            "function": {
              "name": "text",
              "description": "text",
              "parameters": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              },
              "strict": true
            }
          }
        ],
        "top_p": 1,
        "image_config": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "modalities": [
          "text"
        ],
        "bad_words": [
          "text"
        ]
      },
      "default_few_shot_messages": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "optimized_few_shot_messages": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "initial_model": "text",
      "deleted_at": false
    }
  ],
  "total": 0
}

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

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

labelstringRequired

Container label.

initial_modelstringRequired

Initial model slug.

apistring · enumOptional

API type.

Default: chat.completionsPossible values:

default_parametersany ofOptional

Default inference parameters.

or

nullOptional

default_system_promptany ofOptional

Default system prompt.

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

post

/v1/containers

HTTPcURLJavaScriptPython

POST /v1/containers HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 764

{
  "label": "text",
  "initial_model": "text",
  "api": "chat.completions",
  "default_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "default_system_prompt": "text"
}

{
  "id": "text",
  "object": "container",
  "org_id": "text",
  "created_at": "2026-03-19T19:29:06.764Z",
  "label": "text",
  "api": "chat.completions",
  "default_system_prompt": "text",
  "default_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "optimized_system_prompt": "text",
  "optimized_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "default_few_shot_messages": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "optimized_few_shot_messages": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "initial_model": "text",
  "deleted_at": false
}

Get a container

get

Fetch a single container by label within the authenticated project.

Authorizations

ApiKeyAuth

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_idany ofOptional

Organization id.

stringOptional

or

nullOptional

created_atany ofOptional

Creation timestamp.

string · date-timeOptional

or

nullOptional

labelstringRequired

Container label.

apistring · enumOptional

API type.

Default: chat.completionsPossible values:

default_system_promptany ofOptional

Default system prompt.

stringOptional

or

nullOptional

default_parametersany ofOptional

Default inference parameters.

or

nullOptional

optimized_system_promptany ofOptional

Optimized system prompt.

stringOptional

or

nullOptional

optimized_parametersany ofOptional

Optimized inference parameters.

or

nullOptional

default_few_shot_messagesany ofOptional

Default few shot messages.

or

nullOptional

optimized_few_shot_messagesany ofOptional

Optimized few shot messages.

or

nullOptional

initial_modelany ofOptional

Initial model slug.

stringOptional

or

nullOptional

deleted_atbooleanOptional

Soft delete flag.

Default: false

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

get

/v1/containers/{label}

HTTPcURLJavaScriptPython

GET /v1/containers/{label} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "object": "container",
  "org_id": "text",
  "created_at": "2026-03-19T19:29:06.764Z",
  "label": "text",
  "api": "chat.completions",
  "default_system_prompt": "text",
  "default_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "optimized_system_prompt": "text",
  "optimized_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "default_few_shot_messages": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "optimized_few_shot_messages": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "initial_model": "text",
  "deleted_at": false
}

Delete a container

delete

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

Authorizations

ApiKeyAuth

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

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

delete

/v1/containers/{label}

HTTPcURLJavaScriptPython

DELETE /v1/containers/{label} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "object": "container",
  "label": "text",
  "deleted": true
}

Update a container

patch

Update container defaults by label within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

labelstringRequired

Body

application/json

Patchable fields for a container.

default_parametersany ofOptional

Updated default parameters.

or

nullOptional

default_system_promptany ofOptional

Updated system prompt.

stringOptional

or

nullOptional

default_modelany ofOptional

Updated default model id or slug.

string · min: 1Optional

Resource id or label

Example: file_abc123

or

nullOptional

Responses

200

Successful Response

application/json

idstringRequired

Container id.

objectconst: containerOptional

Object type.

Default: container

org_idany ofOptional

Organization id.

stringOptional

or

nullOptional

created_atany ofOptional

Creation timestamp.

string · date-timeOptional

or

nullOptional

labelstringRequired

Container label.

apistring · enumOptional

API type.

Default: chat.completionsPossible values:

default_system_promptany ofOptional

Default system prompt.

stringOptional

or

nullOptional

default_parametersany ofOptional

Default inference parameters.

or

nullOptional

optimized_system_promptany ofOptional

Optimized system prompt.

stringOptional

or

nullOptional

optimized_parametersany ofOptional

Optimized inference parameters.

or

nullOptional

default_few_shot_messagesany ofOptional

Default few shot messages.

or

nullOptional

optimized_few_shot_messagesany ofOptional

Optimized few shot messages.

or

nullOptional

initial_modelany ofOptional

Initial model slug.

stringOptional

or

nullOptional

deleted_atbooleanOptional

Soft delete flag.

Default: false

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

patch

/v1/containers/{label}

HTTPcURLJavaScriptPython

PATCH /v1/containers/{label} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 731

{
  "default_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "default_system_prompt": "text",
  "default_model": "file_abc123"
}

{
  "id": "text",
  "object": "container",
  "org_id": "text",
  "created_at": "2026-03-19T19:29:06.764Z",
  "label": "text",
  "api": "chat.completions",
  "default_system_prompt": "text",
  "default_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "optimized_system_prompt": "text",
  "optimized_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "default_few_shot_messages": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "optimized_few_shot_messages": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "initial_model": "text",
  "deleted_at": false
}

Add a model to a container

post

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

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

modelstringRequired

Model slug or id to add.

containerstringRequired

Container id or label.

slugstringRequired

User specified submodel slug.

default_parametersany ofOptional

Default inference parameters.

or

nullOptional

default_system_promptany ofOptional

Default system prompt.

stringOptional

or

nullOptional

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_parametersany ofOptional

Default inference parameters.

or

nullOptional

default_system_promptany ofOptional

Default system prompt.

stringOptional

or

nullOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

post

/v1/models

HTTPcURLJavaScriptPython

POST /v1/models HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 749

{
  "model": "text",
  "container": "text",
  "slug": "text",
  "default_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "default_system_prompt": "text"
}

{
  "object": "model",
  "id": "text",
  "container_id": "text",
  "slug": "text",
  "container": "text",
  "default_parameters": {
    "provider": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "plugins": [],
    "route": "text",
    "session_id": "text",
    "frequency_penalty": 1,
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "logprobs": true,
    "top_logprobs": 1,
    "max_completion_tokens": 1,
    "max_tokens": 1,
    "presence_penalty": 1,
    "reasoning": {
      "effort": "none",
      "summary": "auto"
    },
    "response_format": {
      "type": "text"
    },
    "seed": 1,
    "stop": "text",
    "temperature": 1,
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "text",
          "description": "text",
          "parameters": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "strict": true
        }
      }
    ],
    "top_p": 1,
    "image_config": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "modalities": [
      "text"
    ],
    "bad_words": [
      "text"
    ]
  },
  "default_system_prompt": "text"
}