Request an avatar or thumbnail upload policy (4 MiB; PNG/JPEG/WebP; 20 images/account/day).

Request an avatar or thumbnail upload policy (4 MiB; PNG/JPEG/WebP; 20 images/account/day). Only processed images are promoted. Repeat the same Idempotency-Key for retries; keys are retained for 24 hours.

post/api/v1/images

Request

  • Base URL: https://portamora.app
  • URL: https://portamora.app/api/v1/images
  • Auth: one of:
    • API key in cookie __Host-session
    • HTTP bearer

Headers

Idempotency-Keystring required
x-amz-content-sha256string required

Lowercase SHA-256 hex of the exact body bytes, including the empty body. The example client adds this automatically; no AWS credentials are needed.

Request body

kind'avatar' | 'thumbnail' required
worldIdstring

Case-sensitive world identifier with 10 safe-alphabet characters after the prefix.

contentType'image/png' | 'image/jpeg' | 'image/webp' required

Response

Successful private response; Cache-Control: no-store.

idstring required

Case-sensitive upload identifier with 10 safe-alphabet characters after the prefix.

worldIdstring nullable required

Case-sensitive world identifier with 10 safe-alphabet characters after the prefix.

versionIdstring nullable required

Case-sensitive version identifier with 10 safe-alphabet characters after the prefix.

kind'package' | 'avatar' | 'thumbnail' required
contentType'application/zip' | 'image/png' | 'image/jpeg' | 'image/webp' required
status'pending' | 'queued' | 'processing' | 'ready' | 'rejected' | 'failed' required
errorstring nullable required
createdAtstring date-time required
expiresAtstring date-time required
maxBytesinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.