datasets

Get Dataset Graph

Get the knowledge graph visualization for a dataset.

This endpoint retrieves the knowledge graph data for a specific dataset, including nodes and edges that represent the relationships between entities in the dataset. The graph data is formatted for visualization purposes.

Path Parameters

dataset_id (UUID): The unique identifier of the dataset

Response

Returns the graph data containing:

nodes: List of graph nodes with id, label, and properties
edges: List of graph edges with source, target, and label

Error Codes

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

GET

api

datasets

{dataset_id}

graph

Get Dataset Graph

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

{
  "nodes": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "label": "<string>",
      "type": "<string>",
      "properties": {}
    }
  ],
  "edges": [
    {
      "source": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "target": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "label": "<string>"
    }
  ]
}

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

Response

Successful Response

nodes

GraphNodeDTO · object[]

required

Show child attributes

edges

GraphEdgeDTO · object[]

required

Show child attributes

Get Dataset DataGet 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 ## Error Codes - **404 Not Found**: Dataset doesn't exist or user doesn't have access - **500 Internal Server Error**: Error retrieving data

⌘I

Get Dataset Graph

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

{
  "nodes": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "label": "<string>",
      "type": "<string>",
      "properties": {}
    }
  ],
  "edges": [
    {
      "source": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "target": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "label": "<string>"
    }
  ]
}

Documentation Index

Authorizations

Path Parameters

Response