Xquik support ticket API for request media uploads

<string>

<string>

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "invalid_range",
  "message": "Use one valid byte range."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

GET

support

attachments

{id}

Xquik support ticket API for request media uploads

curl --request GET \
  --url https://xquik.com/api/v1/support/attachments/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/support/attachments/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/support/attachments/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Support attachments stay private. Every download requires authentication and access to the parent ticket.

curl https://xquik.com/api/v1/support/attachments/att_a1b2c3d4e5f6a1b2c3d4e5f6 \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  --output attachment.bin

const attachmentId = "att_a1b2c3d4e5f6a1b2c3d4e5f6";
const response = await fetch(`https://xquik.com/api/v1/support/attachments/${attachmentId}`, {
  headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
const bytes = new Uint8Array(await response.arrayBuffer());

import requests

attachment_id = "att_a1b2c3d4e5f6a1b2c3d4e5f6"
response = requests.get(
    f"https://xquik.com/api/v1/support/attachments/{attachment_id}",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
)
response.raise_for_status()
media_bytes = response.content

Path parameters

string

required

Attachment public ID from a ticket message or upload receipt.

Headers

string

required

Your API key. Session cookie authentication is also supported.

string

1 standard byte range for video seeking or resumable downloads. Example: bytes=0-1048575.

Supported media

Kind	Formats	Per-file limit
Image	JPEG, PNG, GIF, WebP	10 MB
Video	MP4, MOV, WebM	25 MB

Each message accepts up to 4 files and 30 MB combined. Per-account upload limits also apply. A 429 response includes Retry-After. Xquik validates file signatures and ignores the declared content type. A renamed file with the wrong format fails validation.

Agent workflow

Send multipart fields named attachments.
Read each returned receipt.
Treat ready as downloadable.
Treat failed as unavailable and ask the user to retry.
Fetch the ticket before downloading media.
Use the returned authenticated url unchanged.
Reuse the submission Idempotency-Key when you retry after a network failure.

Ticket and reply retries return the original media receipts. A lost response then creates no duplicate ticket, message, or stored file. Never convert the relative url into a public link. It requires the same account authentication as the ticket.

Range example

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

curl https://xquik.com/api/v1/support/attachments/att_a1b2c3d4e5f6a1b2c3d4e5f6 \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Range: bytes=0-1048575" \
  --output video-part.bin

Response

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

Returns the requested byte range with Content-Range and Accept-Ranges: bytes.

Correct the Range header before retrying.

Wait for the Retry-After value.

Agent status map

Status	Meaning	Agent action
`200`	Complete media	Read or save the body.
`206`	Requested byte range	Continue range requests when needed.
`401`	Authentication failed	Refresh authentication.
`404`	Missing or unauthorized	Do not reveal which condition applied.
`416`	Invalid range	Correct the `Range` header.
`429`	Download limit reached	Wait for `Retry-After`.

Create media with Create Ticket or Reply to Ticket. Read attachment metadata with Get Ticket.

<string>

<string>

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "invalid_range",
  "message": "Use one valid byte range."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Xquik support ticket API for request media uploads

curl --request GET \
  --url https://xquik.com/api/v1/support/attachments/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/support/attachments/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/support/attachments/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Xquik support ticket API for request media uploads

Path parameters

Headers

Supported media

Agent workflow

Range example

Response

Agent status map

​Path parameters

​Headers

​Supported media

​Agent workflow

​Range example

​Response

​Agent status map

Path parameters

Headers

Supported media

Agent workflow

Range example

Response

Agent status map