datasets

Get Datasets Graph Summary

Get node/edge counts per dataset, cached per cognify run.

Counts are computed once per dataset’s latest cognify run and cached in GraphMetrics, keyed by pipeline_run_id — orders of magnitude cheaper on repeat polls than GET //graph, which does a full traversal.

Query Parameters

dataset_ids (List[UUID], optional): Dataset UUIDs to summarize. If omitted, summarizes every dataset the user has read permission on.

Response

Returns a list of summaries containing:

datasetId: The dataset’s UUID
pipelineRunId: The dataset’s latest cognify run, or null if it has never been cognified
numNodes / numEdges: Graph size for that run
computedAt: When the count was cached, or null if the last attempt degraded (graph store unavailable) and wasn’t cached

GET

api

datasets

graph-summary

Get Datasets Graph Summary

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

[
  {
    "datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "numNodes": 123,
    "numEdges": 123,
    "pipelineRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "computedAt": "2023-11-07T05:31:56Z"
  }
]

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

string<uuid>[]

Dataset UUIDs to summarize (from GET /api/v1/datasets). Omit to summarize every dataset you can read.

Example:

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

Response

Successful Response

datasetId

string<uuid>

required

numNodes

integer

required

numEdges

integer

required

pipelineRunId

string<uuid> | null

computedAt

string<date-time> | null

⌘I

Get Datasets Graph Summary

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

[
  {
    "datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "numNodes": 123,
    "numEdges": 123,
    "pipelineRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "computedAt": "2023-11-07T05:31:56Z"
  }
]

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

Getting Started

auth

add

cognify

memify

search

permissions

datasets

ontologies

settings

visualize

schema

skills

configuration

delete

validate

update

responses

llm

sync

users

checks

health

agent management

agent connections

activity

sessions

remember

recall

improve

forget

slack

integrations

Get Datasets Graph Summary

Query Parameters

Response

Authorizations

Query Parameters

Response