remember

Remember

Ingest data and build the knowledge graph in a single call.

This endpoint combines the add and cognify steps. Data is ingested first, then automatically processed into a structured knowledge graph.

Request Parameters

data (List[UploadFile]): Files to upload and process.
datasetName (Optional[str]): Name of the target dataset.
datasetId (Optional[UUID]): UUID of an existing dataset.
node_set (Optional[List[str]]): Node identifiers for graph organisation.
run_in_background (Optional[bool]): Run the cognify step asynchronously (default: False).
custom_prompt (Optional[str]): Custom prompt for entity extraction.
chunk_size (Optional[int]): Maximum tokens per chunk. Defaults to automatic model-based sizing.
chunks_per_batch (Optional[int]): Chunks per cognify batch.

Either datasetName or datasetId must be provided.

Error Codes

400 Bad Request: Neither datasetId nor datasetName provided
409 Conflict: Error during processing

POST

api

remember

Remember

curl --request POST \
  --url https://api.cognee.ai/api/v1/remember \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'data=<string>' \
  --form 'datasetName=<string>' \
  --form datasetId= \
  --form session_id= \
  --form node_set= \
  --form run_in_background=false \
  --form custom_prompt= \
  --form chunk_size=4096 \
  --form chunks_per_batch=36 \
  --form 'content_type=<string>' \
  --form data.items='@example-file'

{}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

data

file[]

datasetName

string | null

datasetId

Example:

""

session_id

string | null

Example:

""

node_set

string[] | null

run_in_background

boolean | null

default:false

custom_prompt

string | null

default:""

chunk_size

integer | null

default:4096

chunks_per_batch

integer | null

default:36

content_type

string | null

Response

Successful Response

The response is of type Response Remember Api V1 Remember Post · object.

Remember EntryStore a typed memory entry in the session cache. Accepts a discriminated union of ``QAEntry``, ``TraceEntry``, ``FeedbackEntry``, or ``SkillRunEntry`` and dispatches to the matching ``remember`` path. Session-backed entries require ``session_id``; ``SkillRunEntry`` can persist with or without one. ## Response The returned ``RememberResult`` includes ``entry_type`` and ``entry_id`` — the ``qa_id``/``trace_id`` returned by the cache (or the ``qa_id`` a feedback was attached to). Use this to chain feedback to a freshly stored QA.

⌘I

Remember

curl --request POST \
  --url https://api.cognee.ai/api/v1/remember \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'data=<string>' \
  --form 'datasetName=<string>' \
  --form datasetId= \
  --form session_id= \
  --form node_set= \
  --form run_in_background=false \
  --form custom_prompt= \
  --form chunk_size=4096 \
  --form chunks_per_batch=36 \
  --form 'content_type=<string>' \
  --form data.items='@example-file'

{}

Documentation Index

Authorizations

Body

Response