Datasets

Dataset management endpoints.

List datasets

get

List datasets owned by 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 datasets.

Default: 100

offsetintegerOptional

Number of datasets to skip.

Default: 0

containerstring · nullableOptional

Container ID or label to filter datasets by.

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/datasets

HTTPcURLJavaScriptPython

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

{
  "object": "list",
  "data": [
    {
      "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-07-21T02:28:13.707Z",
      "tags": [
        "text"
      ],
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "total": 0
}

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.

descriptionstring · nullableOptional

Dataset description.

containerstringRequired

Container id or label for source data.

sizeintegerRequired

Requested dataset size.

tagsstring[] · nullableOptional

Optional dataset tags.

Responses

201

Successful Response

application/json

idstringRequired

ID of the created dataset.

messagestringRequired

Status message.

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/datasets

HTTPcURLJavaScriptPython

POST /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.

descriptionstring · nullableOptional

Dataset description.

user_idstring · nullableOptional

Owner user id.

project_idstring · nullableOptional

Project id.

org_idstring · nullableOptional

Organization id.

container_idstring · nullableOptional

Container id.

requested_sizeinteger · nullableOptional

Requested dataset size.

sizeinteger · nullableOptional

Actual dataset size.

created_atstring · date-time · nullableOptional

Creation timestamp.

tagsstring[] · nullableOptional

Optional dataset tags.

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/datasets/{dataset_id}

HTTPcURLJavaScriptPython

GET /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-07-21T02:28:13.707Z",
  "tags": [
    "text"
  ],
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}