Datasets

List Datasets

get

List datasets for the authenticated organization

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

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

cursorany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

next_cursorany ofOptional

stringOptional

or

nullOptional

has_morebooleanRequired

totalintegerRequired

422

Validation Error

application/json

get

/datasets

HTTPcURLJavaScriptPython

GET /api/public/v1/datasets HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "datasets": [
    {
      "id": "text",
      "num_rows": 1,
      "created_at": "2026-03-10T23:39:50.584Z",
      "updated_at": "2026-03-10T23:39:50.584Z"
    }
  ],
  "next_cursor": "text",
  "has_more": true,
  "total": 1
}

Create Dataset

post

Create a new empty dataset

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

201

Successful Response

application/json

post

/datasets

HTTPcURLJavaScriptPython

POST /api/public/v1/datasets HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

201

Successful Response

{
  "id": "text"
}

Get Dataset

get

Get dataset metadata including ID and row count

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

dataset_idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

num_rowsintegerRequired

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

422

Validation Error

application/json

get

/datasets/{dataset_id}

HTTPcURLJavaScriptPython

GET /api/public/v1/datasets/{dataset_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "num_rows": 1,
  "created_at": "2026-03-10T23:39:50.584Z",
  "updated_at": "2026-03-10T23:39:50.584Z"
}

Get Dataset Samples

get

Get samples from a dataset with cursor-based pagination

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

dataset_idstringRequired

Query parameters

limitinteger · min: 1 · max: 5000OptionalDefault: 1000

cursorany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

next_cursorany ofOptional

stringOptional

or

nullOptional

has_morebooleanRequired

totalintegerRequired

422

Validation Error

application/json

get

/datasets/{dataset_id}/samples

HTTPcURLJavaScriptPython

GET /api/public/v1/datasets/{dataset_id}/samples HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "samples": [
    {
      "seed": {
        "seed_text": "text",
        "url": "text",
        "seed_creation_date": "2026-03-10T23:39:50.584Z",
        "search_query": "text"
      },
      "question": {
        "question_type": "FORWARD_LOOKING_QUESTION",
        "question_text": "text",
        "date_close": "2026-03-10T23:39:50.584Z",
        "event_date": "2026-03-10T23:39:50.584Z",
        "resolution_criteria": "text",
        "prediction_date": "2026-03-10T23:39:50.584Z"
      },
      "label": {
        "label": "text",
        "label_confidence": 1,
        "answer_type": "text",
        "resolution_date": "2026-03-10T23:39:50.584Z",
        "reasoning": "text",
        "answer_sources": "text"
      },
      "prompt": "text",
      "context": [
        {
          "context_type": "NEWS_CONTEXT",
          "rendered_context": "text",
          "search_query": "text"
        }
      ],
      "rollouts": [
        {
          "model_name": "text",
          "content": "text",
          "parsed_output": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "reasoning": "text",
          "reward": 1
        }
      ],
      "meta": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "is_valid": true
    }
  ],
  "next_cursor": "text",
  "has_more": true,
  "total": 1
}

Upload Samples

post

Upload samples to a dataset

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

dataset_idstringRequired

Body

application/json

Responses

200

Successful Response

application/json

countintegerRequired

totalintegerRequired

422

Validation Error

application/json

post

/datasets/{dataset_id}/samples

HTTPcURLJavaScriptPython

POST /api/public/v1/datasets/{dataset_id}/samples HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 821

{
  "samples": [
    {
      "seed": {
        "seed_text": "text",
        "url": "text",
        "seed_creation_date": "2026-03-10T23:39:50.584Z",
        "search_query": "text"
      },
      "question": {
        "question_type": "FORWARD_LOOKING_QUESTION",
        "question_text": "text",
        "date_close": "2026-03-10T23:39:50.584Z",
        "event_date": "2026-03-10T23:39:50.584Z",
        "resolution_criteria": "text",
        "prediction_date": "2026-03-10T23:39:50.584Z"
      },
      "label": {
        "label": "text",
        "label_confidence": 1,
        "answer_type": "text",
        "resolution_date": "2026-03-10T23:39:50.584Z",
        "reasoning": "text",
        "answer_sources": "text"
      },
      "prompt": "text",
      "context": [
        {
          "context_type": "NEWS_CONTEXT",
          "rendered_context": "text",
          "search_query": "text"
        }
      ],
      "rollouts": [
        {
          "model_name": "text",
          "content": "text",
          "parsed_output": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "reasoning": "text",
          "reward": 1
        }
      ],
      "meta": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "is_valid": true
    }
  ]
}

{
  "count": 1,
  "total": 1
}