Skip to main content
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

​
string (uuid)
Only return documents in this folder. Folder ids come from list_folders. Omit to list across the whole workspace.
​
integer
Maximum number of documents to return. Defaults to 25; minimum 1, maximum 100.

​
Output

​
object[]
required

​
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.