Read a confirmed token creator's current published avatar.
GET /api/v1/tokens/{slug}/creator-avatar. Read a confirmed token creator's current published avatar.
Request
GET /api/v1/tokens/{slug}/creator-avatar
The schema permits anonymous access.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
slug | path | string | Yes | min length: 1; max length: 64; pattern: ^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$ | — |
v | query | string | No | pattern: ^[a-f0-9]{16}$ | — |
X-Request-Id | header | string | No | min length: 8; max length: 128; pattern: ^[A-Za-z0-9._:-]+$ | Optional client correlation identifier. The server always generates a separate authoritative request ID and retains a valid supplied value only as secondary audit correlation metadata. |
cURL
Set SLUG to the path and required query values before running this example. URL-encode path values as needed.
curl --fail-with-body --silent --show-error \
--request GET \
--url "https://launch-api.supanova.app/api/v1/tokens/${SLUG}/creator-avatar"Responses
200
Current scanned creator image. Private storage keys and signed URLs are never returned.
| Header | Type | Description |
|---|---|---|
Cache-Control | string | — |
Cross-Origin-Resource-Policy | string | — |
X-Content-Type-Options | string | — |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: image/png
Type: string.
format: binary
Content type: image/jpeg
Type: string.
format: binary
Content type: image/webp
Type: string.
format: binary
400
Invalid token slug or avatar version. Also: VALIDATION_FAILED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
404
The creator has no current published custom avatar.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
429
The caller exceeded an IP or principal request budget.
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Whole seconds to wait before retrying a rate-limited request. |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
503
Image storage is unavailable.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
default
Machine-readable API error. The HTTP status identifies the error class.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
Source contract
This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.