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

containerany ofOptional

Container ID or label to filter datasets 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

/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-03-19T19:29:08.175Z",
      "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.

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

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

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

/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-03-19T19:29:08.175Z",
  "tags": [
    "text"
  ],
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}