komrad

list_documents

List the documents agents have written, without their bodies.

read-onlyidempotentMCP toolAgent

Set agent_id to list one agent's documents.

Calling it#

curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ListDocuments \
  -H 'Content-Type: application/json' \
  -d '{}'

Request#

ListDocumentsRequest#

FieldTypeDescription
agent_iduuid

The agent whose documents to list, by id. Unset lists every agent's, archived agents included.

typestring

not empty

at most 100 characters

The type of documents to list, by name. Unset lists every type.

paginationPagination

The page to read.

one of

The task whose documents to list. Unset lists every task's.

task_iduuid

The task, by id.

task_slugstring

not empty

The task, by slug.

Response#

ListDocumentsResponse#

FieldTypeDescription
documentsDocument[]

One page of documents, most recently written first, without their text.

next_page_tokenstring

The cursor for the next page. Unset on the last page.

Types#

Pagination#

Pagination selects one page of a listing.

FieldTypeDescription
limitint32

at least 0

How many records to return. Komrad caps the value, and picks one when unset.

cursorstring

at most 2048 characters

The next_page_token from the previous response. Unset to start from the first page.

Document#

Document is markdown an agent writes for the person to read.

FieldTypeDescription
iduuid*

The document's id.

agent_iduuid*

The id of the agent that owns the document.

namestring

The document's title. No two of one agent's documents share one.

typestring

The name of the document's type.

bodystring

The document's text, in markdown. Empty in a listing.

created_attimestamp

When the document was created.

updated_attimestamp

When the document was last written.

versionint32

How many times the document has been written.

task_iduuid

The id of the task the agent was on when the document was created. Unset for an orchestrator's documents.