Skip to main content
POST
/
bots
/
create
curl -X POST https://api.phanomcloud.online/bots/create \
  -H "Authorization: Bearer sess_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-discord-bot",
    "language": "nodejs",
    "memory": 256,
    "startup_command": "node index.js",
    "environment": {
      "TOKEN": "your-bot-token",
      "PREFIX": "!"
    }
  }'

{
  "success": true,
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "my-discord-bot",
    "language": "nodejs",
    "memory": 256,
    "vcpu": 0.5,
    "status": "offline",
    "startup_command": "node index.js"
  },
  "message": "Bot created successfully. Use POST /bots/start to run it."
}

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

​
name
string
required
Bot name. Alphanumeric characters, underscores and hyphens only. Example: my-bot.
​
language
string
required
Runtime language. One of: nodejs, python, java, go, rust.
​
memory
number
required
RAM allocation in MB. Example: 256, 512, 1024. The total across all your bots cannot exceed your plan limit.
​
startup_command
string
required
Command to run when the bot starts. Example: node index.js or python main.py.
​
environment
object
Key-value pairs of environment variables to inject into the bot’s container.
vCPU is calculated automatically — 1 vCPU per 512 MB of RAM. A 256 MB bot gets 0.5 vCPU, a 1024 MB bot gets 2 vCPU.

​
Response

​
data
object
The created bot object with status: "offline".
curl -X POST https://api.phanomcloud.online/bots/create \
  -H "Authorization: Bearer sess_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-discord-bot",
    "language": "nodejs",
    "memory": 256,
    "startup_command": "node index.js",
    "environment": {
      "TOKEN": "your-bot-token",
      "PREFIX": "!"
    }
  }'

{
  "success": true,
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "my-discord-bot",
    "language": "nodejs",
    "memory": 256,
    "vcpu": 0.5,
    "status": "offline",
    "startup_command": "node index.js"
  },
  "message": "Bot created successfully. Use POST /bots/start to run it."
}