Skip to main content
POST
/
recall
curl --request POST \ --url https://api.deyta.ai/gateway/v1/recall \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "namespace_id": "ns_abc123", "query": "deployment incidents", "start_time": "2026-01-01T00:00:00Z", "end_time": "2026-03-31T23:59:59Z" } '
{
  "success": true,
  "data": {}
}

Authorizations

​
Authorization
string
header
required

API key obtained from the Deyta Console

Body

application/json
​
query
string
required

Natural language search query.

Minimum string length: 1
​
namespace_id
string

Namespace ID. Required if external_reference_id is not provided.

​
external_reference_id
string

External reference ID to resolve namespace. Required if namespace_id is not provided.

​
limit
number

Maximum number of results to return.

Required range: x >= 1
​
mode
enum<string>

Recall mode for adjusting search behavior.

Available options:
vector,
graph,
hybrid,
all
​
start_time
string<date-time>

Inclusive lower bound on memory event time. ISO-8601. When set, skips NL date detection on the query.

Example:

"2026-01-01T00:00:00Z"

​
end_time
string<date-time>

Inclusive upper bound on memory event time. ISO-8601. When set, skips NL date detection on the query.

Example:

"2026-03-31T23:59:59Z"

Response

Memories retrieved successfully

​
success
boolean
Example:

true

​
data
object

Recalled memories and similarity scores.