datasets
Get Dataset Status
Get the processing status of datasets.
This endpoint retrieves the current processing status of one or more datasets,
indicating whether they are being processed, have completed processing, or
encountered errors during pipeline execution.
## Query Parameters
- **dataset** (List[UUID]): List of dataset UUIDs to check status for.
If omitted, returns status for all datasets the user has read permission on
- **pipeline** (List[str], optional): One or more pipeline names to check.
- If omitted, defaults to **cognify_pipeline** (backward-compatible behavior)
- If one pipeline is provided, response is a flat map
- If multiple pipelines are provided, response is nested per dataset and pipeline
- **Available options: add_pipeline, cognify_pipeline, code_graph_pipeline**
- Note: a background code ingest creates its pipeline run only once the
repository is cloned — a dataset missing from the response means the run
has not started yet, not that it failed
## Response
Returns status information in one of two shapes:
- Single pipeline (default): {dataset_id: status}
- Multiple pipelines: {dataset_id: {pipeline_name: status}}
Status values:
- **pending**: Dataset is queued for processing
- **running**: Dataset is currently being processed
- **completed**: Dataset processing completed successfully
- **failed**: Dataset processing encountered an error
## Error Codes
- **409 Conflict**: Error retrieving status (e.g. requesting a dataset you don't have
read permission for)
GET
Get Dataset Status
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Dataset UUIDs to check (from GET /api/v1/datasets). Omit to get status for all datasets you can read.
Example:
Pipeline names to check: 'add_pipeline', 'cognify_pipeline', or 'code_graph_pipeline' (code ingestion via remember content_type='code'). Omit to default to cognify_pipeline.
Example:
Response
Successful Response
- Response Get Dataset Status Api V1 Datasets Status Get
- Response Get Dataset Status Api V1 Datasets Status Get
Available options:
DATASET_PROCESSING_INITIATED, DATASET_PROCESSING_STARTED, DATASET_PROCESSING_COMPLETED, DATASET_PROCESSING_ERRORED Get Dataset Status