Attachments - Relay

Read the upload state and download URL for stored media.

The Attachment object

Field	Type	Description
`id`	string	Unique identifier for the attachment (UUID)
`filename`	string	Original filename of the attachment
`content_type`	string	Declared MIME type, lowercased. Relay stores and returns the original bytes unchanged.
`size_bytes`	integer	Size of the attachment in bytes
`status`	string	Current upload state.
`download_url` (optional)	string	URL to download the attachment
`created_at`	string	When the attachment was created
`duration_ms` (optional)	integer or null	Audio or video duration in milliseconds when known.
`width` (optional)	integer or null	Pixel width when known. Width and height are supplied together.
`height` (optional)	integer or null	Pixel height when known. Width and height are supplied together.

Example

An attachment object, as GET /v1/attachments/{attachmentId} returns it:

Field	Type	Meaning
`id`	string	Unique identifier for the attachment (UUID)
`filename`	string	Original filename of the attachment
`content_type`	string	Declared MIME type, lowercased
`size_bytes`	integer	Size of the attachment in bytes
`status`	string	Current upload state
`download_url`	string, optional	URL to download the attachment
`created_at`	string	When the attachment was created
`duration_ms`	[‘integer’, ‘null’], optional	Audio or video duration in milliseconds when known
`width`	[‘integer’, ‘null’], optional	Pixel width when known
`height`	[‘integer’, ‘null’], optional	Pixel height when known

Operations

Method	Path	What it does
`POST`	`/v1/attachments`	Pre-upload a file
`GET`	`/v1/attachments/{attachmentId}`	Get attachment metadata
`DELETE`	`/v1/attachments/{attachmentId}`	Delete an attachment

Errors

Common authentication, validation, and server errors apply alongside resource errors. Read error.message for the rejected condition. 1005, 2001, 2003, 2004, 3006.

Next steps