Skip to main content
GET
Support media
Support attachments stay private. Every download requires authentication and access to the parent ticket.

Path parameters

id
string
required
Attachment public ID from a ticket message or upload receipt.

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported.
Range
string
One standard byte range for video seeking or resumable downloads. Example: bytes=0-1048575.

Supported media

Each message accepts up to 4 files and 30 MB combined. Additional per-account upload limits protect service availability. A 429 response includes Retry-After. Xquik validates file signatures instead of trusting the declared content type. Rename-only format changes fail validation.

Agent workflow

  1. Send multipart fields named attachments.
  2. Read each returned receipt.
  3. Treat ready as downloadable.
  4. Treat failed as unavailable and ask the user to retry.
  5. Fetch the ticket before downloading media.
  6. Use the returned authenticated url unchanged.
  7. Reuse the submission Idempotency-Key when a network retry is required.
Ticket and reply retries return the original media receipts. This prevents duplicate tickets, messages, and stored files after a lost response. Never convert the relative url into a public link. It requires the same account authentication as the ticket.

Range example

Video downloads support one standard byte range. Use ranges for seeking or resumable playback.

Response

Returns the complete image or video body with its validated content type.

Agent status map

Create media with Create Ticket or Reply to Ticket. Read attachment metadata with Get Ticket.
Last modified on July 20, 2026