v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
datasets

Api Datasets List List

List datasets

Endpoint: GET /api/datasets/list/

Superadmin: Can see all datasets across all organizations. Regular users: Can only see datasets in their organization.

Returns (200): { "count": 1, "next": null, "previous": null, "results": [ { "id": "dataset_id", "organization_id": 123, "updated_by": {"first_name": "Ann", "last_name": "Lee", "email": "ann@example.com"}, "log_count": 250, "name": "Support Conversations - July", "log_ids": ["..."], "description": "Sampled support chats for July", "type": "sampling", "status": "ready", "created_at": "2025-07-26T00:00:00Z", "updated_at": "2025-07-27T08:10:00Z", "completed_annotation_count": 0, "running_status": "pending", "running_progress": 0 } ] }

get/api/datasets/list/

Query parameters

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

Headers

Authorizationstring required

JWT access token or Respan API key

Response

countinteger required
nextstring uri nullable
previousstring uri nullable
total_countinteger
current_filtersFilterParamDictPydantic

Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters.

Each key is a metric name (str), and each value can be:

  • A single MetricFilterParamPydantic (one condition)
  • A List[MetricFilterParamPydantic] (multiple conditions for same metric)
  • A FilterBundlePydantic (nested filter bundle with connector)

Note: Uses extra="allow" for dynamic metric name fields. The pydantic_extra annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.

filters_dataPaginatedDatasetListListFiltersData