List datasets

GET

/datasets

• Production API

Authorizations

• bearerAuth
• cookieAuth

Parameters

Query Parameters

datasetIds

Comma-separated list of dataset IDs to filter by

string

nullable

Comma-separated list of dataset IDs to filter by

teamIds

Comma-separated list of team IDs to filter by

string

nullable

Comma-separated list of team IDs to filter by

name

Filter datasets by name (partial match)

string

Filter datasets by name (partial match)

tags

Comma-separated list of tags to filter by (any match)

string

nullable

Comma-separated list of tags to filter by (any match)

managed

Filter by managed status: ‘true’ for system-managed, ‘false’ for user-created

string

Allowed values: true false

Filter by managed status: ‘true’ for system-managed, ‘false’ for user-created

page

Page number for pagination (1-indexed)

number

>= 1

Page number for pagination (1-indexed)

pageSize

Number of results per page (1-100, default: 20)

number

>= 1 <= 100

Number of results per page (1-100, default: 20)

orderBy

Field to sort results by

string

Allowed values: createdAt name updatedAt description

Field to sort results by

orderDirection

Sort direction: ascending or descending

string

Allowed values: asc desc

Sort direction: ascending or descending

Responses

200

Datasets retrieved successfully

object

datasets

required

Array of datasets matching the query

Array<object>

object

datasetId

required

Unique identifier for the dataset (nanoid format)

string

teamId

required

ID of the team that owns this dataset

string

name

required

Human-readable name for the dataset

string

description

required

Optional description of the dataset contents and purpose

string

nullable

tags

required

Tags for categorizing and filtering datasets

Array<string>

metadata

required

Arbitrary key-value metadata for custom extensions

object

key

additional properties

nullable

managed

required

Whether this dataset is system-managed (true) or user-created (false)

boolean

createdAt

required

ISO 8601 timestamp when the dataset was created

string format: date-time

updatedAt

required

ISO 8601 timestamp when the dataset was last modified

string format: date-time

total

required

Total number of datasets matching the query (before pagination)

number

page

required

Current page number

number

pageSize

required

Number of results per page

number

400

Bad Request - Validation error or invalid input

object

error

required

string

code

string

details

nullable

retryable

boolean

401

Unauthorized - Authentication required or invalid token

object

error

required

string

code

string

details

nullable

retryable

boolean

403

Forbidden - Insufficient permissions

object

error

required

string

code

string

details

nullable

retryable

boolean