list_documents
The list_documents tool — the documents in your library that the assistant can turn into a signing case.
Lists the documents in your NextSign library (Dashboard → Documents) that the connection may use as the source of a case, newest first. It is the same operation as GET /v3/api/documents and runs through the same handler.
The assistant typically calls this on its own when you mention a template by name — "send our Employment Contract to …" — to find the right document id before calling get_document and create_case_from_document.
Arguments
| Field | Type | Notes |
|---|---|---|
limit | int 1–100 | Documents per page. Default 25 |
cursor | string | nextCursor from a previous result, to fetch the next page |
Unknown arguments are rejected.
Result
{
"documents": [
{
"id": "6a58c2a06f829bebd9232c1b",
"name": "Employment Contract.docx",
"format": "docx",
"private": true,
"shared": false,
"createdAt": "2026-05-12T09:14:08.201Z",
"updatedAt": "2026-05-12T09:14:09.377Z",
"currentVersion": {
"id": "6a58c2a16f829bebd9232c1e",
"versionNumber": 1,
"name": "Employment Contract.docx",
"format": "docx",
"createdAt": "2026-05-12T09:14:09.301Z",
"fieldCount": 27
}
}
],
"nextCursor": null,
"hasMore": false
}format tells the assistant what it is dealing with: a docx is a template with fieldCount fields to fill, a pdf is attached as it is. The field definitions themselves come from get_document.
What is listed is what the connected user would see in the dashboard: the company's non-private documents, the ones that user created, and any another company has shared with yours. A colleague's private document is not listed and cannot be used. See What you see.