Submit a token image as a base64 data URI (max 512KB)
POST
/api/images/submit
const url = 'https://gib.show/api/images/submit';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"chainId":"example","address":"example","image":"example","submittedBy":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://gib.show/api/images/submit \ --header 'Content-Type: application/json' \ --data '{ "chainId": "example", "address": "example", "image": "example", "submittedBy": "example" }'Request Bodyrequired
Section titled “Request Bodyrequired”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"}Responses
Section titled “Responses”Stored image.
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.
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).
object
error
string
Example generated
{ "error": "example"}