Files
Upload a visual file
Uploads a file (image or PDF) to the account's storage as multipart/form-data. The id of the stored file goes in printingVisuals when creating an order, or in shippingFiles for a document shipped with the order (a cover letter in PDF, for example).
Request
Authorization
Bearer token
Send your API key in the Authorization header: Authorization: Bearer sk_test_…. A sk_test_ key creates and sees test orders only. Keys and test mode.
Path parameters
accountIdstringrequiredUnique identifier of the account
Body multipart/form-data
filestring (binary)The file to upload
Responses
201File uploaded successfully
400Bad request, invalid input
Type: Error
401Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (INVALID_TOKEN)
Type: Error
403The API key is inactive or revoked (INACTIVE_API_KEY), or targets another account (ACCOUNT_ACCESS_DENIED, refused once the account guard is enforced); with an OAuth access token: a token of scope mcp (INSUFFICIENT_SCOPE), a path naming another account or a person no longer a member of it (ACCOUNT_ACCESS_DENIED), a real token on the sandbox host (SANDBOX_REQUIRES_TEST_KEY)
Type: Error
404Account not found
Type: Error
429
500Internal server error
Type: Error