Files

Upload a visual file

POST/v2/accounts/{accountId}/filesTry it

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
  • accountIdstringrequired
    Unique 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

Request
curl -X POST "https://api.printags.com/v2/accounts/123e4567-e89b-12d3-a456-426614174000/files" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY" \
  -F "[email protected]"