Skip to content
LogoLogo

Authorize a direct download

Authorize a direct download

POST/api/v1/attachments/{attachment_id}/download

Authorizes the caller against the attachment's Workspace at request time and mints a short-lived presigned download URL bound to one method and one object key. Possession of an attachment identifier or an expired URL never grants access.

The URL is minted per request and must never be stored in Document or comment content, an event payload, a notification, or a webhook. The object is served from a non-Assign origin with Content-Disposition: attachment and X-Content-Type-Options: nosniff; attachments are never rendered inline in an Assign origin.

Only an attachment whose scan_state is clean can receive this credential. This operation is POST because it mints a credential; it is not a cacheable read.

Path Parameters

attachment_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

X-CSRF-Token
string·min 1·max 200

Required when this operation uses browserSession; native bearer callers omit it because no ambient cookie is sent.

Responses