Skip to content
LogoLogo

Authorize an inline attachment preview

Authorize an inline attachment preview

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

Authorizes the caller against the attachment's Workspace at request time and mints a short-lived presigned URL for browser display. The object is served from the cookie-less object-storage origin with an inline disposition, X-Content-Type-Options: nosniff, and the server-detected content type.

Only clean PNG, JPEG, GIF, WebP, AVIF, and PDF attachments are previewable. SVG and every other type remain download-only. The URL is a credential, is minted per request, and must never be stored in content, events, notifications, or webhooks.

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