The API uses standard HTTP status codes. Every error response includes aDocumentation Index
Fetch the complete documentation index at: https://docs.phanomcloud.online/llms.txt
Use this file to discover all available pages before exploring further.
success: false field and an error string describing what went wrong.
HTTP Status Codes
| Code | Meaning | When it happens |
|---|---|---|
200 | OK | Request succeeded |
201 | Created | Resource created successfully |
400 | Bad Request | Invalid body, missing fields, or validation error |
401 | Unauthorized | Token invalid, expired, or missing |
403 | Forbidden | Plan limit reached, insufficient memory, or no permission |
404 | Not Found | Bot, file, or backup doesn’t exist or doesn’t belong to you |
409 | Conflict | State conflict — e.g. bot already online, name already taken |
429 | Too Many Requests | Rate limit exceeded |
500 | Internal Server Error | Unexpected server-side failure |
Common Errors
401 — Unauthorized
401 — Unauthorized
403 — Insufficient memory
403 — Insufficient memory
Your plan does not have enough available memory to create or resize this bot.
409 — Bot already online
409 — Bot already online
You tried to start a bot that is already running.
409 — Bot must be offline
409 — Bot must be offline
Some operations (restore backup, reinstall deps) require the bot to be stopped first.

