# Complete Bot Management APIs (A-Z)

> List, create, deploy, update, restart, soft-delete, restore, and check webhooks remotely.

**Category:** REST API Reference  
**URL:** https://docs.botlify.cloud/?page=api-bots  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

## 1. List Hosted Bots (list_bots)

      

Parameters: `status` (optional: `all`, `active`, `deleted`)

      
```php
curl -s "https://botlify.cloud/user_api.php?action=list_bots&api_key=YOUR_KEY"
```

      

## 2. Get Bot Details (get_bot)

      

Parameters: `bot_id` (Numeric ID or `@username`)

      

Returns storage used, database size, error log line count, webhook URL, and masked token.

      

## 3. Deploy New Bot (create_bot)

      

Parameters: `token` (BotFather token), `admin_chat_id` (optional)

      
```php
curl -X POST https://botlify.cloud/user_api.php   -H "X-API-KEY: YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "action": "create_bot",
    "token": "7123456789:AAHxyz...",
    "admin_chat_id": "7642872720"
  }'
```

      

## 4. Restart & Sync Webhook (restart_bot)

      

Parameters: `bot_id`. Forces re-registration of the HTTPS webhook with Telegram servers.

      

## 5. Toggle Webhook (toggle_webhook)

      

Parameters: `bot_id`, `action_type` (`start`, `stop`, or `toggle`). Pauses or activates live message receiving without altering bot code.

      

## 6. Check Live Webhook Info (webhook_info)

      

Parameters: `bot_id`. Calls Telegram's `getWebhookInfo` API to return pending update counts, last error dates, and SSL handshake status.

      

## 7. Soft-Delete & Restore (delete_bot / restore_bot)

      

Parameters: `bot_id`. Deleting moves the bot into a 30-day recycle bin; restore recovers the full codebase, database, and settings.
