REST API

The Maniac API provides openai compatible inference endpoints for interacting with both frontier models and your custom models. This reference details the available endpoints.

List chat completions

get

List chat completions captured in telemetry, scoped to the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Query parameters

limitinteger · min: 1 · max: 100OptionalDefault: 20

offsetintegerOptionalDefault: 0

modelany ofOptional

stringOptional

or

nullOptional

containerany ofOptional

stringOptional

or

nullOptional

orderstring · enumOptionalDefault: descPossible values:

Body

application/json

or

nullOptional

Responses

200

Successful Response

application/json

OpenAI-style list response for chat completions.

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

/api/v1/chat/completions

HTTPcURLJavaScriptPython

GET /api/v1/chat/completions HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

{
  "object": "list",
  "data": [
    {
      "choices": [
        {
          "finish_reason": "stop",
          "index": 0,
          "message": {
            "content": "Hello!",
            "role": "assistant"
          }
        }
      ],
      "created": 1710000000,
      "id": "chatcmpl-123",
      "model": "openai/gpt-4o",
      "object": "chat.completion"
    }
  ],
  "total": 0
}

Create a chat completion

post

Create a chat completion using the specified model.

Supports both streaming and non-streaming responses and is compatible with OpenAI's chat completions API. Use a container slug (maniac:<container>) or an external slug (e.g. openai/gpt-4o).

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

OpenAI-compatible chat completion request with Maniac extensions.

modelany ofOptional

Model slug to use. Supports global slugs or project slugs (maniac:).

Example: openai/gpt-4o

stringOptional

or

nullOptional

modelsany ofOptional

Fallback models.

string[]Optional

or

nullOptional

frequency_penaltyany ofOptional

Frequency penalty.

numberOptional

or

nullOptional

logit_biasany ofOptional

Logit bias.

or

nullOptional

logprobsany ofOptional

Include logprobs.

booleanOptional

or

nullOptional

top_logprobsany ofOptional

Top logprobs.

numberOptional

or

nullOptional

max_completion_tokensany ofOptional

Max completion tokens.

numberOptional

or

nullOptional

max_tokensany ofOptional

Max tokens.

numberOptional

or

nullOptional

metadataany ofOptional

Arbitrary key/value metadata to attach to the request.

Example: {"source":"dashboard"}

or

nullOptional

presence_penaltyany ofOptional

Presence penalty.

numberOptional

or

nullOptional

reasoningany ofOptional

Reasoning config.

or

nullOptional

response_formatany ofOptional

Response format.

or

or

or

nullOptional

seedany ofOptional

Random seed.

integerOptional

or

nullOptional

stopany ofOptional

Stop sequences.

stringOptional

or

string[]Optional

or

nullOptional

streamany ofOptional

Stream response.

Default: false

booleanOptional

or

nullOptional

stream_optionsany ofOptional

Stream options.

or

nullOptional

temperatureany ofOptional

Temperature.

numberOptional

or

nullOptional

tool_choiceany ofOptional

Tool choice.

string · enumOptionalPossible values:

or

or

nullOptional

toolsany ofOptional

Tools.

or

nullOptional

top_pany ofOptional

Top p.

numberOptional

or

nullOptional

tagsstring[]Optional

Optional tags for tracking.

Example: []

storeany ofOptional

Whether to store the completion in the database.

Default: true

booleanOptional

or

nullOptional

Responses

200

Server-Sent Events stream for streaming responses.

application/jsontext/event-stream

idstringRequired

Completion id.

creatednumberRequired

Creation timestamp (unix).

modelstringRequired

Model used.

objectconst: chat.completionOptional

Object type.

Default: chat.completion

usageany ofOptional

Token usage.

or

nullOptional

providerany ofOptional

Upstream provider name, if available.

stringOptional

or

nullOptional

containerany ofOptional

Container label used for routing, if any.

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

/api/v1/chat/completions

HTTPcURLJavaScriptPython

POST /api/v1/chat/completions HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 88

{
  "messages": [
    {
      "content": "Hello!",
      "role": "user"
    }
  ],
  "model": "openai/gpt-4o",
  "stream": false
}

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "Hello!",
        "role": "assistant"
      }
    }
  ],
  "created": 1710000000,
  "id": "chatcmpl-123",
  "model": "openai/gpt-4o",
  "object": "chat.completion"
}

Get a chat completion

get

Fetch a single chat completion by id within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

completion_idstringRequired

Responses

200

Successful Response

application/json

idany ofOptional

Completion id.

stringOptional

or

nullOptional

createdany ofOptional

Creation timestamp (unix seconds).

anyOptional

or

nullOptional

modelany ofOptional

Model slug used.

stringOptional

or

nullOptional

objectconst: chat.completionOptional

Object type.

Default: chat.completion

usageany ofOptional

Token usage.

or

nullOptional

providerany ofOptional

Upstream provider name, if available.

stringOptional

or

nullOptional

containerany ofOptional

Container label used for routing, if any.

stringOptional

or

nullOptional

model_idany ofOptional

Model ID (uuid).

stringOptional

or

nullOptional

spendany ofOptional

Estimated spend.

numberOptional

or

nullOptional

tagsany ofOptional

Tags for this completion.

string[]Optional

or

nullOptional

metadataany ofOptional

Metadata for this completion.

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

get

/api/v1/chat/completions/{completion_id}

HTTPcURLJavaScriptPython

GET /api/v1/chat/completions/{completion_id} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "Hello!",
        "role": "assistant"
      }
    }
  ],
  "created": 1710000000,
  "id": "chatcmpl-123",
  "model": "openai/gpt-4o",
  "object": "chat.completion"
}

Register chat completion examples

post

Register completed chat examples for evaluation and analytics.

This endpoint accepts input/output pairs and stores them for later analysis, while aggregating usage metrics for reporting.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

Register completed chat examples for evaluation or analytics.

containerstringRequired

Container label to associate these examples with.

Example: maniac:my-container

Responses

200

Successful Response

application/json

okbooleanRequired

Whether the register operation succeeded.

containerstringRequired

Container label used for registration.

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

/api/v1/chat/completions/register

HTTPcURLJavaScriptPython

POST /api/v1/chat/completions/register HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 410

{
  "items": [
    {
      "input": {
        "messages": [
          {
            "content": "Hello!",
            "role": "user"
          }
        ],
        "model": "openai/gpt-4o",
        "stream": false
      },
      "output": {
        "choices": [
          {
            "finish_reason": "stop",
            "index": 0,
            "message": {
              "content": "Hello!",
              "role": "assistant"
            }
          }
        ],
        "created": 1710000000,
        "id": "chatcmpl-123",
        "model": "openai/gpt-4o",
        "object": "chat.completion"
      },
      "tags": [
        "text"
      ],
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "container": "maniac:my-container"
}

{
  "container": "maniac:my-container",
  "errors": [],
  "ok": true,
  "summary": {
    "inserted": 10,
    "skipped": 0
  }
}

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

/api/v1/containers

HTTPcURLJavaScriptPython

GET /api/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-05T04:16:47.487Z",
      "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"
        ]
      },
      "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"
        ]
      },
      "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

/api/v1/containers

HTTPcURLJavaScriptPython

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

{
  "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"
    ]
  },
  "default_system_prompt": "text"
}

{
  "id": "text",
  "object": "container",
  "org_id": "text",
  "created_at": "2026-03-05T04:16:47.487Z",
  "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"
    ]
  },
  "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"
    ]
  },
  "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

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

/api/v1/containers/{label}

HTTPcURLJavaScriptPython

GET /api/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-05T04:16:47.487Z",
  "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"
    ]
  },
  "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"
    ]
  },
  "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

/api/v1/containers/{label}

HTTPcURLJavaScriptPython

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

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

List files (OpenAI-compatible)

get

List files owned by the authenticated project, optionally filtered by purpose.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Query parameters

purposeany ofOptional

Filter by purpose

stringOptional

or

nullOptional

limitinteger · min: 1 · max: 1000Optional

Max number of files.

Default: 100

offsetintegerOptional

Number of files to skip.

Default: 0

Responses

200

Successful Response

application/json

OpenAI-compatible list response for files.

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

503

Upstream Unavailable

application/json

get

/api/v1/files

HTTPcURLJavaScriptPython

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

{
  "object": "list",
  "data": [
    {
      "bytes": 1200,
      "created_at": 1710000000,
      "filename": "training.jsonl",
      "id": "file-123",
      "object": "file",
      "purpose": "fine-tune",
      "status": "uploaded"
    }
  ],
  "total": 0
}

Upload a file

post

Upload a file to the platform. This endpoint accepts a file and a purpose, and uploads the file to the platform, for later use in training or evaluation.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

multipart/form-data

purposestringRequired

filestring · binaryRequired

Responses

201

Successful Response

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Upstream Unavailable

application/json

post

/api/v1/files

HTTPcURLJavaScriptPython

POST /api/v1/files HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 34

{
  "purpose": "text",
  "file": "binary"
}

{
  "bytes": 1200,
  "created_at": 1710000000,
  "filename": "training.jsonl",
  "id": "file-123",
  "object": "file",
  "purpose": "fine-tune",
  "status": "uploaded"
}

Retrieve file metadata

get

Fetch metadata for a single file by id within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

file_idstringRequired

File id (UUID)

Responses

200

Successful Response

application/json

OpenAI-compatible file object (subset).

We keep id as the DB UUID string, and expose the OpenAI-ish envelope.

idstringRequired

File id (UUID).

objectconst: fileOptional

Object type.

Default: file

bytesintegerRequired

File size in bytes.

created_atintegerRequired

Unix timestamp (seconds).

filenamestringRequired

Original filename.

purposestringRequired

Intended file purpose.

statusstringRequired

Current file status.

status_detailsany ofOptional

Optional status details.

stringOptional

or

nullOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Upstream Unavailable

application/json

get

/api/v1/files/{file_id}

HTTPcURLJavaScriptPython

GET /api/v1/files/{file_id} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "bytes": 1200,
  "created_at": 1710000000,
  "filename": "training.jsonl",
  "id": "file-123",
  "object": "file",
  "purpose": "fine-tune",
  "status": "uploaded"
}

Delete a file (OpenAI-compatible)

delete

Soft-delete a file by id within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

file_idstringRequired

File id (UUID)

Responses

200

Successful Response

application/json

OpenAI-compatible delete response.

idstringRequired

File id (UUID).

objectconst: fileOptional

Object type.

Default: file

deletedbooleanOptional

Deletion status.

Default: true

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Upstream Unavailable

application/json

delete

/api/v1/files/{file_id}

HTTPcURLJavaScriptPython

DELETE /api/v1/files/{file_id} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "object": "file",
  "deleted": true
}

Retrieve file content (OpenAI-compatible)

get

Download the raw contents of a file by id within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

file_idstringRequired

File id (UUID)

Responses

200

Raw file bytes

application/jsonapplication/octet-streamapplication/jsonltext/plain

anyOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Upstream Unavailable

application/json

get

/api/v1/files/{file_id}/content

HTTPcURLJavaScriptPython

GET /api/v1/files/{file_id}/content HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List available models

get

List models available to the authenticated project. Optionally filter by container.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Query parameters

limitinteger · min: 1 · max: 100Optional

Max number of models.

Default: 100

offsetintegerOptional

Number of models to skip.

Default: 0

containerany ofOptional

Container ID or label to filter models by.

stringOptional

or

nullOptional

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

/api/v1/models

HTTPcURLJavaScriptPython

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

{
  "object": "list",
  "data": [
    {
      "object": "model",
      "id": "text",
      "slug": "text",
      "pricing": {
        "prompt": "text",
        "completion": "text",
        "image": "text",
        "request": "text",
        "discount": "text",
        "web_search": "text",
        "image_output": "text",
        "input_cache_read": "text",
        "internal_reasoning": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "supported_parameters": [
        "text"
      ],
      "supported_apis": [
        "chat.completions"
      ],
      "provider": "text"
    }
  ],
  "total": 0
}

List evaluators

get

List evaluators for the authenticated project, optionally filtered by container.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Query parameters

containerany ofOptional

stringOptional

or

nullOptional

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

/api/v1/evaluators

HTTPcURLJavaScriptPython

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

{
  "object": "list",
  "data": [
    {
      "object": "evaluator.judge",
      "project_id": "text",
      "container_id": "text",
      "id": "text",
      "name": "text",
      "description": "text",
      "created_at": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "pass_threshold": 1,
      "api": "text",
      "container": "text",
      "model": "text",
      "prompt": "text",
      "inference_parameters": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "total": 0
}

Create an evaluator

post

Create a new evaluator scoped to a project or container.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

containerany ofOptional

Container label.

stringOptional

or

nullOptional

typestring · enumRequired

Evaluator type.

Possible values:

modelany ofOptional

Judge model slug.

stringOptional

or

nullOptional

promptany ofOptional

Judge prompt.

stringOptional

or

nullOptional

sourceany ofOptional

Code evaluator source.

stringOptional

or

nullOptional

requirementsany ofOptional

Optional requirements list.

string[]Optional

or

nullOptional

pass_thresholdany ofOptional

Optional pass threshold.

numberOptional

or

nullOptional

metadataany ofOptional

Optional metadata.

or

nullOptional

nameany ofOptional

Evaluator name.

stringOptional

or

nullOptional

descriptionany ofOptional

Evaluator description.

stringOptional

or

nullOptional

apiany ofOptional

API type.

stringOptional

or

nullOptional

inference_parametersany ofOptional

Optional inference parameters for judge evaluators (e.g. response_format, temperature).

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

/api/v1/evaluators

HTTPcURLJavaScriptPython

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

{
  "container": "text",
  "type": "judge",
  "model": "text",
  "prompt": "text",
  "source": "text",
  "requirements": [
    "text"
  ],
  "pass_threshold": 1,
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "name": "text",
  "description": "text",
  "api": "text",
  "inference_parameters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "object": "evaluator.judge",
  "project_id": "text",
  "container_id": "text",
  "id": "text",
  "name": "text",
  "description": "text",
  "created_at": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "pass_threshold": 1,
  "api": "text",
  "container": "text",
  "model": "text",
  "prompt": "text",
  "inference_parameters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Delete an evaluator

delete

Delete an evaluator by id.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

evaluator_idstringRequired

Responses

200

Successful Response

application/json

objectconst: evaluatorOptional

Object type.

Default: evaluator

idstringRequired

Evaluator id.

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

/api/v1/evaluators/{evaluator_id}

HTTPcURLJavaScriptPython

DELETE /api/v1/evaluators/{evaluator_id} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "object": "evaluator",
  "id": "text",
  "deleted": true
}

Create a dataset

post

Create a dataset for a container using telemetry filters.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

namestringRequired

Dataset name.

descriptionany ofOptional

Dataset description.

stringOptional

or

nullOptional

containerstringRequired

Container id or label for source data.

sizeintegerRequired

Requested dataset size.

tagsany ofOptional

Optional dataset tags.

string[]Optional

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

/api/v1/datasets

HTTPcURLJavaScriptPython

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

{
  "container": "maniac:support",
  "description": "Support chat quality dataset",
  "filters": [
    {
      "key": "model_name",
      "operator": "equals",
      "value": "gpt-4o"
    }
  ],
  "metadata": {
    "source": "dashboard"
  },
  "name": "support-evals",
  "size": 500,
  "tags": [
    "support",
    "evals"
  ]
}

{
  "id": "text",
  "message": "text"
}

Get a dataset

get

Fetch a dataset by id within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

dataset_idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

Dataset id.

objectconst: datasetOptional

Object type.

Default: dataset

namestringRequired

Dataset name.

descriptionany ofOptional

Dataset description.

stringOptional

or

nullOptional

user_idany ofOptional

Owner user id.

stringOptional

or

nullOptional

project_idany ofOptional

Project id.

stringOptional

or

nullOptional

org_idany ofOptional

Organization id.

stringOptional

or

nullOptional

container_idany ofOptional

Container id.

stringOptional

or

nullOptional

requested_sizeany ofOptional

Requested dataset size.

integerOptional

or

nullOptional

sizeany ofOptional

Actual dataset size.

integerOptional

or

nullOptional

filtersany ofOptional

Filters applied when building the dataset.

or

nullOptional

created_atany ofOptional

Creation timestamp.

string · date-timeOptional

or

nullOptional

tagsany ofOptional

Optional dataset tags.

string[]Optional

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

get

/api/v1/datasets/{dataset_id}

HTTPcURLJavaScriptPython

GET /api/v1/datasets/{dataset_id} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "object": "dataset",
  "name": "text",
  "description": "text",
  "user_id": "text",
  "project_id": "text",
  "org_id": "text",
  "container_id": "text",
  "requested_size": 1,
  "size": 1,
  "filters": [
    {
      "key": "text",
      "operator": "equals",
      "value": null
    }
  ],
  "created_at": "2026-03-05T04:16:47.487Z",
  "tags": [
    "text"
  ],
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Healthz

get

Health check endpoint for load balancers and uptime monitors.

Responses

200

Successful Response

application/json

Health check response.

okbooleanRequired

get

/healthz

HTTPcURLJavaScriptPython

GET /healthz HTTP/1.1
Host: platform.maniac.ai
Accept: */*

200

Successful Response

{
  "ok": true
}