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 /{dataset_id}/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 when it wasn’t — either the last attempt degraded (graph store unavailable, counts are 0 and retried on the next poll) or a concurrent caller cached the same run first (counts are exact)

Error Codes

409 Conflict: The summary could not be built (generic message; the detail is server-logged rather than returned). A single unreadable graph store does not cause this — that dataset comes back with zero counts — so this means the relational read itself failed.

GET

api

datasets

graph-summary

Get Datasets Graph Summary

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

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/datasets/graph-summary"

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

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

print(response.text)

[
  {
    "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://{tenant}.aws.cognee.ai/api/v1/datasets/graph-summary \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/datasets/graph-summary"

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

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

print(response.text)

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

Error Codes

Authorizations

Query Parameters

Response