Skip to navigation
Gateway APIDocs

Read a document

View as Markdown

Read the full markdown of a Basement strategy document by ID. Records an agent read for observability.

Authentication

AuthorizationBearer

A Basement key (bsmt_...), from Agents, Connect in the app.

Request

This endpoint expects an object.
docIdstringRequired

The document ID from list_docs

agentNamestringOptional
Optional agent name for attribution

Response

The tool's answer.
idstring
titlestring
bodyMarkdownstring
The document's full markdown
versionCountinteger
The version that was read

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error