Skip to main content
POST
/
bots
/
start
curl -X POST https://api.phanomcloud.online/bots/start \
  -H "Authorization: Bearer sess_..." \
  -H "Content-Type: application/json" \
  -d '{ "bot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }'

{
  "success": true,
  "message": "Bot \"my-discord-bot\" is starting",
  "data": { "status": "starting" }
}

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.

​
Body

​
bot_id
string
required
UUID of the bot to start.
The response is returned immediately with status: "starting". Track the real status via GET /bots/:id or stream logs with GET /bots/:id/logs/stream.

​
Process

  1. Validates ownership
  2. Creates a Docker container (bot_<id>) with --memory and --cpus limits
  3. Starts the container
  4. Begins async log capture
  5. Updates status to "online" once running
curl -X POST https://api.phanomcloud.online/bots/start \
  -H "Authorization: Bearer sess_..." \
  -H "Content-Type: application/json" \
  -d '{ "bot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }'

{
  "success": true,
  "message": "Bot \"my-discord-bot\" is starting",
  "data": { "status": "starting" }
}