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
For in-flight progress (files completed / total, current stage), see GET /v1/datasets/status/progress — a separate endpoint with its own fixed response shape, rather than a flag here that would change what this endpoint returns depending on how it’s called.
Error Codes
- 403 Forbidden: The request owner cannot read every requested dataset
- 409 Conflict: An unexpected error occurred while retrieving 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.
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.
Response
Successful Response
- Response Get Dataset Status Api V1 Datasets Status Get
- Response Get Dataset Status Api V1 Datasets Status Get
DATASET_PROCESSING_INITIATED, DATASET_PROCESSING_STARTED, DATASET_PROCESSING_COMPLETED, DATASET_PROCESSING_ERRORED