Upload a new custom character from a ZIP archive.

POST 
/api/characters

The ZIP must contain a valid character package (manifest, 3D assets, portrait). Maximum file size: 100 MB. Only .zip files are accepted. The operation is asynchronous — poll GET /api/characters/jobs/{jobId} for completion.

Request

Responses

202

Upload accepted. Poll the jobs endpoint for progress.

400

Invalid input — missing file, wrong format, or missing name.

401

Missing or invalid authentication.