Skip to main content
POST
Upload or import a reusable reference image

Authorizations

Authorization
string
header
required

Mint API key sent as a Bearer token.

Headers

Idempotency-Key
string

Optional stable key for safely retrying an uncertain mutating request. Mint creates an internal key when this header is omitted. Reusing a supplied key with different parameters returns 409.

Required string length: 1 - 255

Body

application/json

Import one reusable reference image from a public URL or base64 data.

sourceUrl
string<uri>

Public HTTPS URL to the image; do not combine with base64Data.

base64Data
string

Base64-encoded image bytes; requires fileName and contentType.

fileName
string

Original file name for a base64 upload.

Required string length: 1 - 160
contentType
string

Image MIME type for a base64 upload.

Required string length: 1 - 100
name
string

Optional reference image title shown in Mint.

Required string length: 1 - 120

Response

Reference image created.

One account-owned asset from the Mint library.

object
any
required

Stable object discriminator.

type
enum<string>
required

Mint asset type.

Available options:
world,
model,
asset_pack,
material,
material_pack,
image,
audio,
reference_image
id
string
required

Mint asset ID.

name
string | null

Asset title shown in Mint.

status
string | null

Current asset status, when available.

thumbnailUrl
string<uri> | null

Asset thumbnail URL, when available.

createdAt
string<date-time> | null

When the asset was created.

updatedAt
string<date-time> | null

When the asset last changed.

items
object[]

Asset Pack or Material Pack items, when applicable.