Bots · Developer account
deleteBot
Delete a bot
This method authenticates with your developer account. The easiest way to call it is the dashboard, which signs the request for you. Direct calls need a dashboard session cookie.
Soft-deletes the bot (row kept 30 days per code comment). Everything stops immediately: all tokens revoked at once, all webhook rows deleted (no more deliveries or retries).
Request
curl https://api.sprintelex.com/deleteBot \
# authenticated with your dashboard session \
-H "Content-Type: application/json" \
-d '{"bot_id":"<bot-id>","confirm":true}'Parameters
| Name | Type | Required | Rules |
|---|---|---|---|
| bot_id | string | Yes | - |
| confirm | boolean | Yes | must be exactly true, otherwise the call is rejected |
Response
{ ok: true, result: { deleted: true } }Rate limit: none in code
Errors
| Status | Error | When |
|---|---|---|
| 400 | bot_id is required | missing bot_id |
| 400 | confirm must be true to delete a bot | confirm is not exactly true |
| 404 | bot not found | no such bot, not owned by caller, or already deleted |
| 500 | could not delete bot | soft-delete update failed |