Get Recall History - Cognee Documentation

GET

api

recall

Get Recall History

curl --request GET \
  --url https://api.cognee.ai/api/v1/recall \
  --header 'Authorization: Bearer <token>'

import requests

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

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

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

print(response.text)

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "text": "<string>",
    "user": "<string>",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

Authorization

string

header

required

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

Response

200 - application/json

Successful Response

string<uuid>

required

text

string

required

user

string

required

createdAt

string<date-time>

required

RecallRecall 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 - **409 Conflict**: Error during recall - **403 Forbidden**: Permission denied (returns empty list) - **422 Unprocessable Entity**: Recall prerequisites not met — ingest data first (POST /v1/remember or /v1/add followed by /v1/cognify)

⌘I

Get Recall History

curl --request GET \
  --url https://api.cognee.ai/api/v1/recall \
  --header 'Authorization: Bearer <token>'

import requests

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

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

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

print(response.text)

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "text": "<string>",
    "user": "<string>",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]