Upload an asset

curl https://api.tapace.lk/v1/assets \ -H "Authorization: Bearer $TAPACE_API_KEY" \ -H "Idempotency-Key: 1c7f3a9e-5b2d-4e8a-a4c6-8d2f1b9e3a70" \ -H "Content-Type: application/json" \ -d "{ \"slot\": \"icon\", \"data\": \"$(base64 -w0 icon.png)\" }"

{ "object": "asset", "id": "asset_Xr9Lm2Qv7Tn4Kp8Zs1Wd", "slot": "icon", "contentType": "image/png", "byteSize": 4821, "width": 87, "height": 87, "createdAt": "2026-10-13T08:55:00.000Z" }

Upload images before you create a template, then reference the returned id in the template’s definition.images. Assets are shared by test and live.

string

required

A unique value for this request.

string

required

Where the image goes on the pass: icon, logo, strip, thumbnail, background, footer or hero.

string

required

The image file, base64-encoded. Up to 5 MiB, and from 16 to 4000 pixels on each side.

string

The file’s MIME type, such as image/png. TapAce checks the file itself, so this is optional.

Response

string

Unique ID, starting with asset_.

string

The slot the image was uploaded for.

string

The stored image’s MIME type.

integer

The stored image’s size in bytes.

integer

Width in pixels.

integer

Height in pixels.

Errors

Status	When
`400`	The slot is unknown, the file is empty or not a valid image, or its size in pixels is out of range.
`413`	The file is larger than 5 MiB.

curl https://api.tapace.lk/v1/assets \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 1c7f3a9e-5b2d-4e8a-a4c6-8d2f1b9e3a70" \
  -H "Content-Type: application/json" \
  -d "{ \"slot\": \"icon\", \"data\": \"$(base64 -w0 icon.png)\" }"

{
  "object": "asset",
  "id": "asset_Xr9Lm2Qv7Tn4Kp8Zs1Wd",
  "slot": "icon",
  "contentType": "image/png",
  "byteSize": 4821,
  "width": 87,
  "height": 87,
  "createdAt": "2026-10-13T08:55:00.000Z"
}

Getting started

Basics

Guides

API keys

Passes

Templates

Assets

Upload an asset

Response

Errors

​Response

​Errors

Response

Errors