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

Filter: lerobot_v3 or sarm_progress

string | null

Filter: lerobot_v3 or sarm_progress

direction

Filter: input or output

string | null

Filter: input or output

project_id

Filter by project

string | null format: uuid

Filter by project

job_id

Filter by job

string | null format: uuid

Filter by job

search

Search dataset path

string | null

<= 200 characters

Search dataset path

limit

integer

default: 20 >= 1 <= 1000

cursor

Pagination cursor

string | null

Pagination cursor

sort

string

default: newest

Allowed values: newest oldest updated name

Header Parameters

x-api-key

string | null

Responses

200

Paginated list of user’s datasets

Media type application/json

PaginatedDatasetsResponse

object

items

Array<object>

DatasetItem

object

artifact_id

required

Artifact ID

string format: uuid

subtype

required

Dataset subtype (lerobot_v3, sarm_progress)

string

path

required

HuggingFace dataset path

string

metadata

object

key

additional properties

any

jobs

Array<object>

JobLink

object

job_id

required

string format: uuid

direction

required

Input or output

string

created_at

required

string format: date-time

updated_at

required

string format: date-time

page_info

required

PageInfo

object

has_next

required

Whether more items exist after this page

boolean

end_cursor

Cursor for the next page

string | null

total_count

Total matching items

integer | 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

Error message describing what went wrong

string

Example ^generated

{
  "detail": "example"
}

422

Invalid pagination parameters