v2
latestOpenAPI 3.1.02026-08-05267431678.1 KBList Datasets
List all datasets for the authenticated user.
By default, returns only the latest version of each dataset. Set include_all_versions=True to return all versions. If project_id is provided, returns datasets for that project plus orphan datasets.
Failed datasets (status='failed') are hidden from the default response. They are preserved in the database — the raw upload, processing_error, and column_mapping columns stay populated so support tooling can replay or inspect them.
Pass include_failed=true to surface the caller's own failed rows (e.g. for an "uploads" / "history" view that wants to show error details). The flag is purely a result-set toggle — it does not relax the user-scoping that runs underneath, so it's safe for any authenticated caller. There is intentionally no admin-only gate; if cross-user visibility is ever needed it should be a separate, explicitly-authenticated endpoint.
Query parameters
Filter by project ID (includes datasets with no project)
Filter by project ID (includes datasets with no project)
When true, include the caller's own failed datasets (status='failed'). Defaults to false so the UI never renders broken-but-clickable records that 404 on preview/analyze. The result set is always scoped to the authenticated user — this flag does NOT grant cross-user visibility, so passing true is safe for any authenticated caller. Failed rows remain in the database for support / debugging; their original upload is preserved at raw_s3_key.
When true, include the caller's own failed datasets (status='failed'). Defaults to false so the UI never renders broken-but-clickable records that 404 on preview/analyze. The result set is always scoped to the authenticated user — this flag does NOT grant cross-user visibility, so passing true is safe for any authenticated caller. Failed rows remain in the database for support / debugging; their original upload is preserved at raw_s3_key.
Response
Successful Response