Support

Submit a Support Request

Submits a support request and returns the resulting record. Requires authentication, but no particular permission.

A request is a subject and a plain-text message. The email PackageX sends is formatted for you, so you do not need to supply HTML.

There is no to, cc, bcc, from or from_name. A support request always comes from PackageX and always goes to PackageX support, so neither end is yours to set. reply_to is the one address you control.

# Attaching files

Files are uploaded directly to storage rather than being sent through this API, so a large screen recording is not limited by request or email size.

The response returns an object_path, an upload_url and a required_headers map. Upload the file to that URL with a PUT, then pass the object_path in attachments when you submit the request. The upload URL is valid for one hour, and we confirm the file actually arrived when you submit.

The response also returns required_headers. Send every one of them on your PUT, exactly as given, including x-goog-content-length-range even for a small file. They are signed into the upload URL, so a request that omits one is rejected with a 403 signature error rather than a helpful message. Files larger than 500MB are rejected either by the upload itself or when you submit the request.

        # 1. Request an upload slot
curl -X POST https://api.packagex.io/v1/support/attachments \
  -H "x-api-key: $PX_API_KEY" -H "Content-Type: application/json" \
  -d '{ "filename": "screen-recording.mp4", "content_type": "video/mp4" }'

# 2. Upload the file to the returned upload_url
curl -X PUT "$UPLOAD_URL" --upload-file screen-recording.mp4 \
  -H "Content-Type: video/mp4" \
  -H "x-goog-content-length-range: 0,524288000"

# 3. Submit the request
curl -X POST https://api.packagex.io/v1/support \
  -H "x-api-key: $PX_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "reply_to": "requester@customer.example",
    "subject": "App crashes when scanning a label",
    "body": "It closes as soon as the camera opens. Recording attached.",
    "attachments": ["support-emails/org_1a2b3c/sup_att_a1b2c3/screen-recording.mp4"]
  }'

      

Attached files appear in the delivered email as links, which stay valid for 90 days. They download rather than open in the browser, and anyone holding the link can use it within that window.

# Errors

A rejected request is still recorded, with a failed status and the reason in errors.