recall

Recall

Recall information from the knowledge graph.

This is a memory-oriented alias for the search endpoint. All search types and options from v1 are supported.

Request Parameters

Field names are shown camelCased in the schema (e.g. searchType, datasetIds, topK); both camelCase and snake_case are accepted.

search_type (Optional[SearchType]): Type of search to perform (default: GRAPH_COMPLETION). Pass null to enable automatic query routing.
datasets (Optional[List[str]]): Dataset names to search within
dataset_ids (Optional[List[UUID]]): Dataset UUIDs to search within; take precedence over dataset names when both are provided
query (str): The search query string
system_prompt (Optional[str]): System prompt for completion searches
node_name (Optional[List[str]]): Filter to specific node sets
top_k (Optional[int]): Maximum results (default: 15)
only_context (bool): Return only the LLM context
verbose (bool): Verbose output
include_references (bool): Include source/provenance references in completion results (default: true)
session_id (Optional[str]): Session whose cached QA and trace entries should be searched
scope (Optional[str | List[str]]): Memory sources to include: “graph”, “session”, “trace”, “session_context”, “all”, “auto”, or a list of these (default: “auto” — session first when session_id is set, else graph)

Error Codes

402/403/404/409/422: Cognee errors (payment required, permission denied, missing user, session-dataset conflict, prerequisites not met) return their own status code and message via the global error handler
409 Conflict: Unexpected non-Cognee error during recall

POST

api

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": [
    "default_dataset"
  ],
  "datasetIds": null,
  "query": "What is in the document?",
  "systemPrompt": "Answer the question using the provided context. Be as brief as possible.",
  "nodeName": null,
  "topK": 15,
  "onlyContext": false,
  "verbose": false,
  "includeReferences": false,
  "sessionId": null,
  "scope": null,
  "contextProfile": "qa"
}
'

import requests

url = "https://api.cognee.ai/api/v1/recall"

payload = {
    "searchType": "GRAPH_COMPLETION",
    "datasets": ["default_dataset"],
    "datasetIds": None,
    "query": "What is in the document?",
    "systemPrompt": "Answer the question using the provided context. Be as brief as possible.",
    "nodeName": None,
    "topK": 15,
    "onlyContext": False,
    "verbose": False,
    "includeReferences": False,
    "sessionId": None,
    "scope": None,
    "contextProfile": "qa"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

[
  {
    "time": "<string>",
    "question": "<string>",
    "context": "<string>",
    "answer": "<string>",
    "source": "session",
    "qa_id": "<string>",
    "feedback_text": "<string>",
    "feedback_score": 123,
    "used_graph_element_ids": {},
    "memify_metadata": {},
    "used_session_context_ids": [
      "<string>"
    ]
  }
]

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

Body

application/json

searchType

enum<string> | null

default:GRAPH_COMPLETION

Search strategy, e.g. GRAPH_COMPLETION, RAG_COMPLETION, CHUNKS, SUMMARIES. Pass null to let cognee auto-route the query to the best strategy.

Available options:

SUMMARIES,

CHUNKS,

RAG_COMPLETION,

HYBRID_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,

CODE

datasets

string[] | null

Dataset names to search within. Omit (null) to search all datasets you have read access to.

Example:

["default_dataset"]

datasetIds

string<uuid>[] | null

Dataset UUIDs to search within; takes precedence over 'datasets' names when both are provided. Leave empty to resolve by name.

Example:

null

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

Restrict results to these node sets (the node_set values passed to /v1/add or /v1/remember). Omit to search all nodes.

Example:

null

topK

integer | null

default:15

onlyContext

boolean

default:false

verbose

boolean

default:false

includeReferences

boolean

default:false

Include source/provenance references in completion results.

sessionId

string | null

Session whose cached QA and trace entries should be searched. With search_type null and no datasets, session hits short-circuit the graph search.

Example:

null

scope

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

Example:

null

contextProfile

string

default:qa

Profile to render for the 'session_context' scope: 'qa' (conversational) or 'agent' (tool/workflow). Ignored by other scopes.

Response

Successful Response

ResponseQAEntry
ResponseAgentTraceEntry
ResponseSessionContextEntry
ResponseGraphEntry

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 | null

Show child attributes

memify_metadata

Memify Metadata · object | null

Show child attributes

used_session_context_ids

string[] | null

⌘I

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": [
    "default_dataset"
  ],
  "datasetIds": null,
  "query": "What is in the document?",
  "systemPrompt": "Answer the question using the provided context. Be as brief as possible.",
  "nodeName": null,
  "topK": 15,
  "onlyContext": false,
  "verbose": false,
  "includeReferences": false,
  "sessionId": null,
  "scope": null,
  "contextProfile": "qa"
}
'

import requests

url = "https://api.cognee.ai/api/v1/recall"

payload = {
    "searchType": "GRAPH_COMPLETION",
    "datasets": ["default_dataset"],
    "datasetIds": None,
    "query": "What is in the document?",
    "systemPrompt": "Answer the question using the provided context. Be as brief as possible.",
    "nodeName": None,
    "topK": 15,
    "onlyContext": False,
    "verbose": False,
    "includeReferences": False,
    "sessionId": None,
    "scope": None,
    "contextProfile": "qa"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

[
  {
    "time": "<string>",
    "question": "<string>",
    "context": "<string>",
    "answer": "<string>",
    "source": "session",
    "qa_id": "<string>",
    "feedback_text": "<string>",
    "feedback_score": 123,
    "used_graph_element_ids": {},
    "memify_metadata": {},
    "used_session_context_ids": [
      "<string>"
    ]
  }
]

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

update

responses

llm

sync

users

checks

health

agent management

agent connections

activity

sessions

remember

recall

improve

forget

slack

integrations

Recall

Request Parameters

Error Codes

Authorizations

Body

Response