Upload an Attachment file (legacy workflow)

Upload file data to an existing Attachment as the second step of the supported legacy two-request workflow. First POST JSON metadata to /attachment.json, including related_object, related_object_uuid, and file_type (for example, .pdf), then use the returned x-record-uuid here. Send the non-empty file bytes as an application/octet-stream request body, or send one file using multipart/form-data. For raw uploads the existing record supplies the file extension; for multipart uploads include the extension in the uploaded filename and ensure it matches the record's file type. Authenticate with an API key or an OAuth token with manage_attachments. Send Accept: application/json for the JSON success response; legacy clients may receive a text/html response. For new integrations, use the single multipart POST to /attachment.json described in the attachment guide.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

UUID of an existing Attachment record.

Body Params

One non-empty file.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

The file is missing or invalid.

401

Authentication credentials are missing or invalid.

403

The caller does not have permission to upload this attachment.

404

The Attachment record does not exist. Create its metadata before uploading file data.

411

The raw upload was shorter than the supplied Content-Length.

415

Array-style multiple-file uploads are unsupported.

429

API rate limit exceeded.

500

The file could not be processed.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html