Skip to main content
POST
/
ask
curl --request POST \
  --url https://api.deyta.ai/gateway/v1/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "namespace_id": "ns_abc123",
  "query": "What deployment incidents happened in Q1?",
  "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 query to synthesize an answer for.

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.

​
config
object

Optional configuration for synthesis behavior.

​
start_time
string<date-time>

Inclusive lower bound on memory event time. ISO-8601. When set, skips NL date detection on the query. Acts as the outer hard cap for any internal memory_recall calls; server may narrow further but never broadens.

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. Acts as the outer hard cap for any internal memory_recall calls; server may narrow further but never broadens.

Example:

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

Response

Synthesized answer generated successfully

​
success
boolean
Example:

true

​
data
object

Synthesized answer and source memories.