List User Datasets

GET

/v1/datasets/list

curl --request GET \
  --url 'https://example.com/v1/datasets/list?limit=20&sort=newest'

List the current user’s datasets with cursor-based pagination.

Parameters

Query Parameters

dataset_type

Any of:

string

string

null

null

Filter: lerobot_v3 or sarm_progress

direction

Any of:

string

string

null

null

Filter: input or output

project_id

Any of:

string

string format: uuid

null

null

Filter by project

job_id

Any of:

string

string format: uuid

null

null

Filter by job

search

Any of:

string

string

<= 200 characters

null

null

Search dataset path

limit

Limit

integer

default: 20 >= 1 <= 1000

cursor

Any of:

string

string

null

null

Pagination cursor

sort

Sort

string

default: newest

Allowed values: newest oldest updated name

Header Parameters

x-api-key

Any of:

string

string

null

null

Responses

200

Paginated list of user’s datasets

Media type application/json

PaginatedDatasetsResponse

object

items

Items

Array<object>

DatasetItem

object

artifact_id

required

Artifact Id

Artifact ID

string format: uuid

subtype

required

Subtype

Dataset subtype (lerobot_v3, sarm_progress)

string

path

required

Path

HuggingFace dataset path

string

metadata

Metadata

object

key

additional properties

any

jobs

Jobs

Array<object>

JobLink

object

job_id

required

Job Id

string format: uuid

direction

required

Direction

Input or output

string

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

page_info

required

PageInfo

object

has_next

required

Has Next

Whether more items exist after this page

boolean

end_cursor

Any of:

string

string

null

null

total_count

Any of:

integer

integer

null

null

Example ^generated

{
  "items": [
    {
      "artifact_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "subtype": "example",
      "path": "example",
      "metadata": {},
      "jobs": [
        {
          "job_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
          "direction": "example"
        }
      ],
      "created_at": "2026-04-15T12:00:00Z",
      "updated_at": "2026-04-15T12:00:00Z"
    }
  ],
  "page_info": {
    "has_next": true,
    "end_cursor": "example",
    "total_count": 1
  }
}

401

Invalid or missing API key

Media type application/json

ErrorResponse

Standard error response.

object

detail

required

Detail

Error message describing what went wrong

string

Example ^generated

{
  "detail": "example"
}

422

Invalid pagination parameters