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.

Pass a folderId to narrow the list to one folder. Folder ids come from list_folders.

Input

folderId · string (uuid)

Only return documents in this folder. Folder ids come from list_folders. Omit to list across the whole workspace.

limit · integer

Maximum number of documents to return. Defaults to 25; minimum 1, maximum 100.

Output

documents · object[] · required

Show properties

id · string · required

Document id. Pass this to get_document.

title · string · required

Document title.

summary · string · required

Short summary of the document. Empty when none has been written.

status · string · required

Document status.

folderId · string · required

Id of the folder holding this document. null when the document is not in a folder.

workspaceId · string · required

Id of the workspace the document belongs to.

updatedAt · string · required

When the document was last updated.

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.
• The list carries no tickets. Use get_document for a document’s tickets and generation status.