Skip to main content
GET
/
api
/
v1
/
datasets
/
status
Get Dataset Status
curl --request GET \
  --url https://api.cognee.ai/api/v1/datasets/status \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.cognee.ai/api/v1/datasets/status"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
{}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
dataset
string<uuid>[]

Dataset UUIDs to check (from GET /api/v1/datasets). Omit to get status for all datasets you can read.

Example:
["b8a7c3de-4f5a-4b6c-8d9e-0f1a2b3c4d5e"]
​
pipeline
string[]

Pipeline names to check: 'add_pipeline' or 'cognify_pipeline'. Omit to default to cognify_pipeline.

Example:
["cognify_pipeline"]

Response

Successful Response

​
{key}
enum<string>
Available options:
DATASET_PROCESSING_INITIATED,
DATASET_PROCESSING_STARTED,
DATASET_PROCESSING_COMPLETED,
DATASET_PROCESSING_ERRORED