Upload Dropship Logo
POST/api/portal/dropship/branding/logo
Uploads the logo printed on blind dropship packing slips and returns the updated branding. Send as multipart/form-data.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Body
logo(file, required) — PNG, JPG or SVG, at most 1 MB and at most 2000 px on either side. SVGs may not contain scripts, event handlers or external references; they are converted to PNG where the server supports it.
Orders already placed keep printing the logo they were placed with.
Returns 422 when the file is missing, too large, not an image, or an unsafe SVG. Returns 403 with code: dropship_branding_not_allowed and a message saying why when the buyer is not a company admin, dropship is not turned on for the account, or the merchant manages the branding itself. Viewers get 403 viewer_read_only. Rate limited to 20 requests/minute.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.