Skip to main content
GET
Get attachment metadata

Authorizations

Authorization
string
header
required

Bearer token authentication. Include your API token in the Authorization header.

Format: Authorization: Bearer <your-token>

Path Parameters

attachmentId
string<uuid>
required

Unique identifier of the attachment

Response

Attachment found and returned successfully

id
string
required

Unique identifier for the attachment (UUID)

filename
string
required

Original filename of the attachment

content_type
string
required

Declared MIME type, lowercased. Relay stores and returns the original bytes unchanged.

Maximum string length: 255
Pattern: ^[A-Za-z0-9!#$%&'*+.^_`|~-]+/[A-Za-z0-9!#$%&'*+.^_`|~-]+$
size_bytes
integer<int64>
required

Size of the attachment in bytes

status
enum<string>
required

Current upload state.

Available options:
pending,
complete,
failed
created_at
string<date-time>
required

When the attachment was created

download_url
string<uri>

URL to download the attachment

duration_ms
integer | null

Audio or video duration in milliseconds when known.

Required range: x >= 0
width
integer | null

Pixel width when known. Width and height are supplied together.

Required range: x >= 1
height
integer | null

Pixel height when known. Width and height are supplied together.

Required range: x >= 1