Dataset
get/api/v1/datasets

Request

Query parameters

limitnumber

Number of results (max 100, default 20). Used with cursor pagination.

cursorstring

Cursor from the previous response next_cursor field.

statusstring

Filter by status. Omit or leave empty for no status filter. Cursor list: pending | running | awaiting_input | succeeded | failed. Offset list (page/perPage): failed | in_progress (or inprogress) | complete, or a legacy exact dataset status. complete is status ready.

qstring

Case-insensitive search. A dataset matches when the text is in its name or its description.

created_afterstring

ISO 8601 datetime — datasets created after this time.

created_beforestring

ISO 8601 datetime — datasets created before this time.

sortstring

Sort field: created_at | updated_at | name (default: created_at).

sort_directionstring

Sort direction: asc | desc (default: desc).

created_by_user_idstring

Filter datasets by creator. The user must belong to the same team as the caller.

typestring

Filter by how the dataset was created: original | combined | augmented | invented. Omit or leave empty for no type filter.

Response

next_cursorstring nullable

Cursor for the next page. Null when no more results.

Example response

{
  "datasets": [
    {
      "dataset_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "My training data",
      "status": "pending",
      "row_count": 1000
    }
  ],
  "next_cursor": "550e8400-e29b-41d4-a716-446655440000"
}

Changes