---
title: "Retrieve Context"
method: POST
path: "/v1/retrieval"
tags: ["retrieval"]
---

# Retrieve Context

`POST /v1/retrieval`

Retrieve relevant context from a vault based on a prompt.

Returns chunks of text with source information. Use this endpoint when
you want to build your own prompts or use the context with a different LLM.

Authentication: X-API-Key header required.

## Headers

- `X-API-Key` string, nullable

## Request body

- RetrievalRequest — Request body for retrieval endpoints.
  - `prompt` string, required — The query/question to search for
  - `limit` integer — Maximum number of results
  - `depth` integer — Graph traversal depth

## Response `200`

Successful Response

- RetrievalResponse — Response from retrieval endpoint.
  - `data` RetrievalDataItem[], required — Retrieved context items
    - `text` string, required — Retrieved text content
    - `sources` SourceInfo[] — Sources for this content
      - `source_id` string, required — Document ID from the source system
      - `source_url` string, nullable — URL to the source document
      - `source_data_type` string, required — Type of data (File, Email, Page, etc.)
      - `source_integration` string, required — Integration name (GoogleDrive, Gmail, Notion, etc.)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)