Skip to main content
POST
/
v1
/
retrieval
Retrieve Context
curl --request POST \
  --url https://api.ontora.com/v1/retrieval \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "limit": 20,
  "depth": 2,
  "rerank": true
}
'
{
  "data": [
    {
      "text": "<string>",
      "sources": [
        {
          "source_id": "<string>",
          "source_data_type": "<string>",
          "source_integration": "<string>",
          "source_url": "<string>"
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.ontora.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Clerk-issued RS256 JWT.

Headers

X-API-Key
string | null

Body

application/json

Request body for retrieval endpoints.

prompt
string
required

The query/question to search for

limit
integer
default:20

Maximum number of results

Required range: 1 <= x <= 100
depth
integer
default:2

Graph traversal depth

Required range: 1 <= x <= 3
rerank
boolean
default:true

Whether to rerank results for relevance

Response

Successful Response

Response from retrieval endpoint.

data
RetrievalDataItem · object[]
required

Retrieved context items