Get a document's download link
GET/v1/documents/{documentId}/download
Returns a signed link, valid for 5 minutes, that downloads the file under its name (an n8n HTTP Request node can fetch it as binary). A pending document is a 409 upload_incomplete.
Permissions: documents:read · Kind: read · Cost: 1 unit
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
documentId |
uuid | yes |
Query parameters
None.
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
"document_download" | yes | |
documentId |
uuid | yes | |
name |
string | yes | |
mimeType |
string | yes | |
byteSize |
integer | yes | ≥ 0 |
url |
uri | yes | A signed link that downloads the file as name. |
expiresAt |
string | yes |
Errors
Errors are problem details. Besides the refusals described above, any call like this one can return:
invalid_request— Invalid requestunauthorized— Missing or invalid API keyinsufficient_scope— Missing permissionrate_limited— Rate limit reachednot_found— Not found