Create a world or allocate its next version and return a presigned multipart POST policy (6 MiB ZIP; 10 packages/account/day).

Create a world or allocate its next version and return a presigned multipart POST policy (6 MiB ZIP; 10 packages/account/day). Requires worlds:write. Repeat the same Idempotency-Key for retries; keys are retained for 24 hours.

post/api/v1/uploads

Request

  • Base URL: https://portamora.app
  • URL: https://portamora.app/api/v1/uploads
  • 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

worldIdstring

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

notesstring
contentType'application/zip'

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
versionNumberinteger required

Changes

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