How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cognee datasets API

Dataset management and introspection

Cognee datasets API is one of 7 APIs that Cognee publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Datasets. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 11 operations across 8 paths, and defines 6 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.cognee.ai, http://localhost:8000.

11 operations 8 paths 6 schemas 3 DELETE6 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.cognee.ai
Authentication
HTTP Bearer, API Key
License
Resource Areas
1

Authentication & Security 2

Cognee datasets API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). An API key is passed in the header as X-Api-Key (ApiKeyAuth). By default, every request must be authenticated.

  • BearerAuth — Bearer token authentication for self-hosted instances
  • ApiKeyAuth — API key authentication for Cognee Cloud deployments

Paths & Operations 11

Across 8 paths, the API surfaces 11 operations — 3 DELETE, 6 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

datasets 11

Dataset management and introspection

GET
/api/v1/datasets
List all accessible datasets
getDatasets → 200418
POST
/api/v1/datasets
Create a new dataset
createDataset body → 200418
DELETE
/api/v1/datasets
Delete all user datasets
deleteAllDatasets → 200
GET
/api/v1/datasets/status
Get dataset processing status
getDatasetStatus 2 params → 200500
DELETE
/api/v1/datasets/{dataset_id}
Delete a dataset by ID
deleteDataset 1 param → 200404500
GET
/api/v1/datasets/{dataset_id}/data
List all data items in a dataset
getDatasetData 1 param → 200404500
DELETE
/api/v1/datasets/{dataset_id}/data/{data_id}
Delete a specific data item from a dataset
deleteDataItem 2 params → 200404500
GET
/api/v1/datasets/{dataset_id}/data/{data_id}/raw
Download the raw data file for a data item
downloadRawData 2 params → 200404501
GET
/api/v1/datasets/{dataset_id}/graph
Get knowledge graph for a dataset
getDatasetGraph 1 param → 200404500
GET
/api/v1/datasets/{dataset_id}/schema
Get graph schema for a dataset
getDatasetSchema 1 param → 200404
PUT
/api/v1/datasets/{dataset_id}/schema
Update graph schema for a dataset
updateDatasetSchema 1 param body → 200404

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are DataItem (8 properties), Dataset (5 properties), GraphNode (4 properties), GraphEdge (3 properties). Each schema is shown below with its type and property counts.

ErrorResponse
object
2 properties 1 required
DataItem
object
8 properties 7 required
GraphNode
object
4 properties 4 required
Dataset
object
5 properties 4 required
Graph
object
2 properties 2 required
GraphEdge
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cognee-datasets-api-openapi.yml Raw ↑

Other APIs Cognee publishes across the network.

Cognee agents API
Cognee cognify API
Cognee data API
Cognee health API
Cognee search API
Cognee settings API
Where this information came from

This is an independent, third-party profile of Cognee datasets API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.