documents

Internal Lookup Documents

Agent-facing lookup endpoint, authorized via internal-secret header.

Resolves the session's attachments via the interview→template chain and calls the same retrieval engine the public route uses.

The agent passes its own self._session_id, which is the LiveKit room name (not a Postgres UUID). We resolve via _resolve_session_id — the same helper /v1/sessions/internal/trace uses — so either form works.

post/v1/documents/internal/lookup

Request body

session_idstring required
querystring required
section_hintstring nullable
top_kinteger
turn_nointeger nullable
attachment_idsstring[]
template_idstring nullable

Response

Successful Response

{"stackTrail":"paths:/v1/documents/internal/lookup:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.