Skip to main content
POST
/
api
/
v1
/
recall
Recall
curl --request POST \
  --url https://api.cognee.ai/api/v1/recall \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "searchType": "GRAPH_COMPLETION",
  "datasets": [
    "<string>"
  ],
  "datasetIds": [],
  "query": "What is in the document?",
  "systemPrompt": "Answer the question using the provided context. Be as brief as possible.",
  "nodeName": [],
  "topK": 10,
  "onlyContext": false,
  "verbose": false,
  "sessionId": "<string>",
  "scope": "<string>"
}
'
[
  {
    "time": "<string>",
    "question": "<string>",
    "context": "<string>",
    "answer": "<string>",
    "source": "<string>",
    "qa_id": "<string>",
    "feedback_text": "<string>",
    "feedback_score": 123,
    "used_graph_element_ids": {},
    "memify_metadata": {}
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.cognee.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
searchType
enum<string> | null
default:GRAPH_COMPLETION
Available options:
SUMMARIES,
CHUNKS,
RAG_COMPLETION,
TRIPLET_COMPLETION,
GRAPH_COMPLETION,
GRAPH_COMPLETION_DECOMPOSITION,
GRAPH_SUMMARY_COMPLETION,
CYPHER,
NATURAL_LANGUAGE,
GRAPH_COMPLETION_COT,
GRAPH_COMPLETION_CONTEXT_EXTENSION,
FEELING_LUCKY,
TEMPORAL,
CODING_RULES,
CHUNKS_LEXICAL,
AGENTIC_COMPLETION
​
datasets
string[] | null
​
datasetIds
string<uuid>[] | null
Example:
[]
​
query
string
default:What is in the document?
​
systemPrompt
string | null
default:Answer the question using the provided context. Be as brief as possible.
​
nodeName
string[] | null
Example:
[]
​
topK
integer | null
default:10
​
onlyContext
boolean
default:false
​
verbose
boolean
default:false
​
sessionId
string | null
​
scope

Which memory sources to include: 'graph', 'session', 'trace', 'graph_context', 'all', or a list. Defaults to 'auto' (session first when session_id is set, else graph).

Response

Successful Response

​
time
string
required
​
question
string
required
​
context
string
required
​
answer
string
required
​
source
string
required
Allowed value: "session"
​
qa_id
string | null
​
feedback_text
string | null
​
feedback_score
integer | null
​
used_graph_element_ids
Used Graph Element Ids · object
​
memify_metadata
Memify Metadata · object