/v1/files/{id}/shareShare a file by link
Mint a signed download URL for one file that works for 7 days, for handing it to somebody outside the workspace who has no seat, and answer {url, expiresAt}. Anyone holding the URL can download the file until it expires, and it cannot be revoked early, so reach for the 15-minute download route instead when the person asking will open it themselves. The share is filed on the workspace's activity feed. Refused with 409 while a document is locked waiting for its unlocked canonical PDF, and 503 when this deployment has no file storage.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"expiresAt": "string",
"url": "string"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}