Prepare artwork upload

POST

/artwork/uploads

Create a signed private R2 upload URL and artworkRef for the appearance design. Send the returned headers and exact file bytes.

Required permissions: binders:write. MCP tool: prepare_artwork_upload.

Authorization

apiKey

headerAuthorizationBearer <Holo Folder personal API key>

Request Body

application/json

body

id*string

Match

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Formatuuid

mimeType*string

Value in"image/png""image/jpeg""image/webp"

size*integer

Range0 < value <= 5242880

Response Body

Success

Example Request

curl -X POST 'https://app.holofolder.com/app/api/v1/artwork/uploads' \  -H 'Content-Type: application/json' \  -d '{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "mimeType": "image/png",  "size": 1}'

Example Response

Empty

Loading API explorer…

Prepare artwork upload

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Request Body

Response Body

Authorization

Request Body

Response Body