datasets

Get Dataset Data

Get all data items in a dataset.

This endpoint retrieves all data items (documents, files, etc.) that belong to a specific dataset. Each data item includes metadata such as name, type, creation time, and storage location.

Path Parameters

dataset_id (UUID): The unique identifier of the dataset

Response

Returns a list of data objects containing:

id: Unique data item identifier
name: Data item name
created_at: When the data was added
updated_at: When the data was last updated
extension: File extension
mime_type: MIME type of the data
raw_data_location: Storage location of the raw data
dataset_id: ID of the containing dataset

Error Codes

404 Not Found: Dataset doesn’t exist or user doesn’t have access
500 Internal Server Error: Error retrieving data

GET

api

datasets

{dataset_id}

data

Get Dataset Data

curl --request GET \
  --url https://api.cognee.ai/api/v1/datasets/{dataset_id}/data \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "extension": "<string>",
    "mimeType": "<string>",
    "rawDataLocation": "<string>",
    "datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

Authorization

string

header

required

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

Path Parameters

dataset_id

string<uuid>

required

Dataset UUID, the id field from GET /api/v1/datasets (not the name)

Example:

"b8a7c3de-4f5a-4b6c-8d9e-0f1a2b3c4d5e"

Response

Successful Response

string<uuid>

required

name

string

required

createdAt

string<date-time>

required

extension

string

required

mimeType

string

required

rawDataLocation

string

required

datasetId

string<uuid>

required

updatedAt

string<date-time> | null

Get Dataset StatusGet 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** ## 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)

⌘I

Get Dataset Data

curl --request GET \
  --url https://api.cognee.ai/api/v1/datasets/{dataset_id}/data \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "extension": "<string>",
    "mimeType": "<string>",
    "rawDataLocation": "<string>",
    "datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
]