Upload QR graphic asset REST API

PUT

/api/sites/{id}/qr-codes/{qrID}/asset

curl --request PUT \
  --url https://hitkeep.com/api/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/qr-codes/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/asset \
  --header 'Content-Type: multipart/form-data' \
  --cookie hk_token=<hk_token> \
  --form asset=@file

Stores a PNG, JPEG, or WebP graphic for a QR code under the configured HitKeep data directory and persists only metadata in the control-plane database. Maximum size is 2 MB. Requires site.manage_data.

Authorizations

• cookieAuth

Parameters

Path Parameters

id

required

string format: uuid

qrID

required

string format: uuid

Request Body^required

Media typemultipart/form-data

object

asset

required

string format: binary

Responses

200

QR asset

Media typeapplication/json

Public QR graphic metadata. The raster image is stored under the configured HitKeep data directory; filesystem storage keys and binary payloads are not exposed in JSON or table takeout.

object

byte_size

integer

checksum

string

content_type

string

Allowed values: image/png image/jpeg image/webp

created_at

string format: date-time

filename

string

height

integer

qr_code_id

string format: uuid

site_id

string format: uuid

updated_at

string format: date-time

width

integer

Example

{
  "content_type": "image/png"
}

400

Invalid asset

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}

413

Asset too large

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}