Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.phanomcloud.online/llms.txt

Use this file to discover all available pages before exploring further.

The API uses standard HTTP status codes. Every error response includes a success: false field and an error string describing what went wrong.
{
  "success": false,
  "error": "Bot not found or does not belong to this user"
}

HTTP Status Codes

CodeMeaningWhen it happens
200OKRequest succeeded
201CreatedResource created successfully
400Bad RequestInvalid body, missing fields, or validation error
401UnauthorizedToken invalid, expired, or missing
403ForbiddenPlan limit reached, insufficient memory, or no permission
404Not FoundBot, file, or backup doesn’t exist or doesn’t belong to you
409ConflictState conflict — e.g. bot already online, name already taken
429Too Many RequestsRate limit exceeded
500Internal Server ErrorUnexpected server-side failure

Common Errors

Your session_token is missing, invalid, or has been revoked. Re-authenticate to get a new one.
{ "success": false, "error": "Unauthorized" }
Your plan does not have enough available memory to create or resize this bot.
{ "success": false, "error": "Insufficient memory: need 512MB, only 256MB available" }
You tried to start a bot that is already running.
{ "success": false, "error": "Bot is already online" }
Some operations (restore backup, reinstall deps) require the bot to be stopped first.
{ "success": false, "error": "Bot must be offline before reinstalling dependencies. Stop the bot first." }