Start or Stop bot

POST

https://api.bots.business/v2/bots/{id}/status

Last modified:2025-11-01 13:12:53

Use this endpoint to start or stop a bot runtime process.

Request

Path Params

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

🟠401Unauthorized

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

Launch BotStop Bot

curl --location --request POST 'https://api.bots.business/v2/bots/1234/status?api_key=UKDZu-c68cubrIbniuE2P_nWj0p5r4IHARNrAV-I' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "start_launch"
}'

Response Example

200 - Success

{
    "id": 2792787,
    "name": "My new bot",
    "token": "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
    "created_at": "2025-10-25T10:14:49.880Z",
    "updated_at": "2025-10-25T10:14:50.181Z",
    "csv_url": "https://example.com/mybot.csv",
    "last_run_at": "2025-10-25T10:14:49.880Z",
    "store_bot_id": 123,
    "git_remote": "https://github.com/bots-business/TalkWithAdminBot.git",
    "rsa_public_key": "ssh-ed25519 AAAAC3NzaC1l...Tfl0Pg bot_2794952@bots.business",
    "is_protected": false,
    "cloud_id": 123,
    "dead_at": "2025-10-25T10:14:49.880Z",
    "pic_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRCJ7n7Rar-oteLCggjf_X3pnLA7V8SHBtpuQ&s",
    "invalid_token_at": "2025-10-25T10:14:49.880Z",
    "status": "works"
}

Modified at 2025-11-01 13:12:53

Delete Bot

Start CSV import