REST API (v1)
The server side of the digiarena Python SDK; the SDK is a thin wrapper — you can curl everything without it.
Authentication
Create an API key on the Settings page and send it with every request:
curl https://digiarena.org/api/v1/usage \ -H "Authorization: Bearer da_live_..."
Error responses are always {ok: false, code, error, fixes: []}; endpoints marked “coming soon” currently return 501 (routes and response schemas are frozen).
| Endpoint | Description | Auth | Status |
|---|---|---|---|
| GET/api/v1/scenes?query=&public= | Search scenes | Public | Live |
| GET/api/v1/scenes/{ns}/{id} | Scene detail (scene packages never leave the platform) | Public | Live |
| POST/api/v1/scenes | Create scene metadata (content is authored in the hosted editor) | API key | Live |
| POST/api/v1/scenes/{ns}/{id}/fork | Fork into your namespace | API key | Coming soon |
| POST/api/v1/gyms | Create gym session (deploy) | API key | Coming soon |
| GET/api/v1/gyms/{id} | Poll gym status | API key | Coming soon |
| DELETE/api/v1/gyms/{id} | Teardown gym | API key | Coming soon |
| POST/api/v1/gyms/{id}/extend | Extend gym lease | API key | Coming soon |
| GET/api/v1/gyms/{id}/logs | Tail gym logs | API key | Coming soon |
| GET/api/v1/benchmarks | List published benchmarks | Public | Live |
| GET/api/v1/benchmarks/{b}/leaderboard | Leaderboard (public) | Public | Live |
| POST/api/v1/benchmarks/{b}/submissions | Create eval submission | API key | Coming soon |
| GET/api/v1/benchmarks/{b}/submissions/{id} | Submission progress / result | API key | Coming soon |
| GET/api/v1/usage | Monthly quota / usage | API key | Live |