Skip to content

Submit a token image as a base64 data URI (max 512KB)

POST
/api/images/submit
curl --request POST \
--url https://gib.show/api/images/submit \
--header 'Content-Type: application/json' \
--data '{ "chainId": "example", "address": "example", "image": "example", "submittedBy": "example" }'
Media type: application/json
object
chainId
required

Prefixed or bare chain id.

string
address
required
string
image
required

Data:image/…;base64,… (max 512KB)

string
submittedBy
required
string

Example generated

{
"chainId": "example",
"address": "example",
"image": "example",
"submittedBy": "example"
}

Stored image.

Media type: application/json
object
imageHash
string
imageUrl
string

Example generated

{
"imageHash": "example",
"imageUrl": "example"
}

Missing fields, invalid data URI, decoded image over the 512 KB limit, an unrecognized format, or an image that cannot be cleaned. Gib re-encodes PNG, JPEG, GIF, WebP and AVIF and sanitizes SVG; it refuses any other raster format (APNG, BMP, TIFF, ICO), an undecodable raster and a malformed SVG.

Media type: application/json
object
error
string

Example generated

{
"error": "example"
}

Request body exceeds the 1 MB JSON parser limit (the decoded image limit itself is 512 KB; base64 encoding inflates payloads by about a third).

Media type: application/json
object
error
string

Example generated

{
"error": "example"
}