API Documentation

Automate your workflow by using the BotNova Developer APIs. You can generate an API key in your Account Settings. All requests must include the \`Authorization: Bearer <API_KEY>\` header.

GET

/api/v1/bots

Retrieve a list of all your deployed Telegram bots.

curl -X GET https://botnova.anujbusiness.in/api/v1/bots \
  -H "Authorization: Bearer bn_your_api_key_here"

Sample Response

{
  "bots": [
    {
      "spaceName": "my-new-bot",
      "name": "My New Bot",
      "createdAt": "2026-07-22T00:00:00.000Z",
      "status": "RUNNING"
    }
  ]
}

POST

/api/v1/bots/create

Deploy a new BotNova node.

curl -X POST https://botnova.anujbusiness.in/api/v1/bots/create \
  -H "Authorization: Bearer bn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "botToken": "TELEGRAM_BOT_TOKEN"
  }'

Sample Response

{
  "success": true,
  "spaceName": "my-new-bot",
  "url": "https://huggingface.co/spaces/your-username/my-new-bot",
  "message": "Bot deployed successfully and is now running."
}

POST

/api/v1/bots/update

Update the source code of an existing bot.

curl -X POST https://botnova.anujbusiness.in/api/v1/bots/update \
  -H "Authorization: Bearer bn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceName": "my-new-bot",
    "code": "print("Hello World")"
  }'

Sample Response

{
  "success": true,
  "message": "Code updated. Bot is restarting.",
  "status": "BUILDING"
}

DELETE

/api/v1/bots/delete

Delete a bot completely and remove it from Hugging Face.

curl -X DELETE https://botnova.anujbusiness.in/api/v1/bots/delete \
  -H "Authorization: Bearer bn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceName": "my-new-bot"
  }'

Sample Response

{
  "success": true,
  "message": "Bot deleted successfully."
}

GET

/api/v1/bots/status

Check the current running status of a bot.

curl -X GET "https://botnova.anujbusiness.in/api/v1/bots/status?spaceName=my-new-bot" \
  -H "Authorization: Bearer bn_your_api_key_here"

Sample Response

{
  "status": "RUNNING",
  "spaceName": "my-new-bot"
}