Upload an item
POST/item.upload
Upload a file so that it can be sent as a chat message attachment. The returned object contains an item ID which can be used with chat.post.
Unlike other endpoints, this uses raw binary upload with metadata in HTTP headers rather than JSON. This is more efficient for file transfers.
Limits:
- Maximum file size: 10 MB
Supported Content Types:
| Content-Type | In-Product Behavior |
|---|---|
image/png, image/jpeg, image/gif, image/webp | Displayed inline with preview thumbnail |
application/octet-stream | Download link only (no preview) |
Important: Use application/octet-stream for any file type not listed above (e.g., .txt, .docx, .xlsx, .zip, .pdf, etc.).
These files will be stored and downloadable, but won't have in-product preview functionality.
Validation:
- The
Content-Typeheader must match the actual file content (server validates this for images) - For images, if the filename lacks the correct extension, it will be appended automatically
Access: Organization only.
Required scope: item:write
OpenAPI Spec: chat.json
Request
Responses
- 200
- 400
- 401
- 405
- 415
- 500
Item uploaded successfully
Bad request.
Presented invalid authentication credentials.
An unsupported method was requested.
An unsupported media type was provided.
An internal error occured.