API
POST /api/recall
Recall
POST /api/recall
Recall
Authentication: Authorization: Bearer <key> or X-API-Key: <key>. Create keys at developers.cognitivx.io/keys.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
X-Org-ID | header | string | null | No | - |
Request body
A JSON request body is required.
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | - |
limit | integer | No | Defaults to 10. |
memory_type | string | null | No | - |
temporal | string | null | No | - |
deep | boolean | No | Defaults to false. |
agent_slug | string | null | No | - |
Example request
curl -X POST https://api.cognitivx.io/api/recall \
-H "Authorization: Bearer icog_..." \
-H "Content-Type: application/json" \
-d '{
"query": "what did we decide about billing",
"limit": 10,
"memory_type": "semantic",
"temporal": null,
"deep": false,
"agent_slug": null
}'Example response
200 application/json
{
"memories": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"text": "Parsa prefers limit/offset pagination",
"memory_type": "semantic",
"age_days": 1,
"created_at": "2026-06-16T08:30:00Z",
"occurred_at": "2026-06-16T08:30:00Z",
"occurred_at_end": null,
"occurred_precision": null,
"similarity": 0.83,
"temporal_context": "Parsa prefers limit/offset pagination"
}
],
"count": 10
}Responses
| Status | Description |
|---|---|
200 | Success. Returns the response body shown below. |
422 | Request validation failed. detail lists each offending field. |