Create an image upload

POST

/v2/themes/{themeId}/rive-graphics/images

curl --request POST \
  --url https://api.ligr.live/rest/v2/themes/1/rive-graphics/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "filename": "example", "size": 1, "sha256": "example", "contentType": "image/png" }'

• LIGR REST API

Beta. This operation can change between minor versions. See Beta status.

Creates a signed upload session for one image. Upload the exact bytes with a single PUT to url, and send headers. Then supply fileId to a Rive asset or an asset exposure of this theme.

Authorizations

• bearer
  themes:write
• api_key
  themes:write

Parameters

Path Parameters

themeId

required

number format: double

Request Body^required

Media typeapplication/json

object

filename

required

string

size

required

integer format: int32

>= 1 <= 26214400

sha256

required

Lowercase hexadecimal SHA-256 of the exact bytes you will PUT.

string

contentType

required

string

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

Responses

201

Created

Media typeapplication/json

object

fileId

required

Numeric file id. Send it as fileId to PUT …/assets/{id}/file, or as defaultFileId on an asset exposure.

number format: double

url

required

string

expiresAt

required

string

headers

required

object

x-amz-checksum-sha256

required

string

Example^generated

{
  "fileId": 1,
  "url": "example",
  "expiresAt": "example",
  "headers": {
    "x-amz-checksum-sha256": "example"
  }
}