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, type, 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>'

import requests

url = "https://api.cognee.ai/api/v1/datasets/{dataset_id}/graph"

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

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

print(response.text)

{
  "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>"
    }
  ]
}

{
  "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.

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

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 - **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

⌘I

Get Dataset Graph

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

import requests

url = "https://api.cognee.ai/api/v1/datasets/{dataset_id}/graph"

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

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

print(response.text)

{
  "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>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}