Skip to main content

Upload an attachment

Uploads a single file (max 25MB) and attaches it to the ticket as an agent message. Send multipart/form-data with one part named file.

Path Parameters
id string — REQUIRED

The ticket ID.

Query Parameters
bot string — REQUIRED

The unique ID of the bot.

Request Body — REQUIRED
file binary — REQUIRED

The file to upload (max 25MB).

Responses
201

File uploaded and attached.

Schema — OPTIONAL
attachment object — OPTIONAL
url string — OPTIONAL
fileName string — OPTIONAL
fileSize integer — OPTIONAL
mimeType string — OPTIONAL
400

No file provided, file exceeds 25MB, wrong field name, or more than one file sent.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

401

Missing/invalid API key.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

404

Ticket not found.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

429

Rate limit exceeded.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

500

Internal server error.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.