POST/files

Upload a file

Upload a file so it can be attached to a conversation reply, note, or ticket. Send the raw file bytes as the request body (not multipart/form-data) and the file name as the `name` query parameter. The response carries a `fileId`: attach it by setting `attachments: [{ fileId }]` on the reply/note/ticket request.

Parameters

Name	In	Type	Description
`name`required	query	`string`	File name, including its extension

Response

File uploaded

Field	Type	Description
`fileId`required	`string`	TypeID - a type-prefixed UUID
`url`required	`string`	Storage URL to attach by fileId; omit it and send fileId instead of url
`name`required	`string`
`contentType`required	`string`
`size`required	`number`	Size in bytes
`family`required	`string`	File family (image, pdf, document, ...)

Errors

400Missing file name, or an empty body

401Unauthorized

413File too large for its type

415File type not allowed

Example request

curl \
  -X POST \
  "https://feedback.quackback.io/api/v1/files" \
  -H "Authorization: Bearer qb_your_api_key_here"