> ## Documentation Index
> Fetch the complete documentation index at: https://docs.montra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# list_documents

> List recent Montra documents in the connected workspace, optionally limited to one folder.

Lists the most recently updated documents in the workspace this connection is bound to. This is the usual starting point: pick a document here, then read it in full with [`get_document`](/tools/get-document).

Pass a `folderId` to narrow the list to one folder. Folder ids come from [`list_folders`](/tools/list-folders).

## Input

<ParamField body="folderId" type="string (uuid)">
  Only return documents in this folder. Folder ids come from [`list_folders`](/tools/list-folders). Omit to list across the whole workspace.
</ParamField>

<ParamField body="limit" type="integer">
  Maximum number of documents to return. Defaults to 25; minimum 1, maximum 100.
</ParamField>

## Output

<ResponseField name="documents" type="object[]" required>
  <Expandable title="properties">
    <ResponseField name="id" type="string" required>Document id. Pass this to [`get_document`](/tools/get-document).</ResponseField>
    <ResponseField name="title" type="string" required>Document title.</ResponseField>
    <ResponseField name="summary" type="string" required>Short summary of the document. Empty when none has been written.</ResponseField>
    <ResponseField name="status" type="string" required>Document status.</ResponseField>
    <ResponseField name="folderId" type="string" required>Id of the folder holding this document. `null` when the document is not in a folder.</ResponseField>
    <ResponseField name="workspaceId" type="string" required>Id of the workspace the document belongs to.</ResponseField>
    <ResponseField name="updatedAt" type="string" required>When the document was last updated.</ResponseField>
  </Expandable>
</ResponseField>

## Notes

* Results are ordered by recency, newest first, whether or not a folder filter is applied. With a `folderId`, the folder's documents are read first and the limit is applied afterwards, so the newest ones survive the cut rather than the oldest.
* Documents are never returned from outside the bound workspace, even ones your user account can otherwise reach. See [workspace binding](/authentication#workspace-binding).
* The list carries no tickets. Use [`get_document`](/tools/get-document) for a document's tickets and generation status.