API Reference › Bots — Webhooks
Remove Webhooks
DELETE
/bots/{bot_id}/callbacksWith no query, removes every webhook on the bot. With url, removes that URL; add events to unsubscribe only those.
Have the bot POST its events to your HTTPS endpoint. Events: instant_message, chat_message, group_message, group_invite, balance_changed, script_dialog, teleport_status, online_status, offer_inventory, offer_friendship, offer_teleport, offer_friendship_accepted, offer_friendship_declined, start_typing, stop_typing — or "all".
Usage
curl -X DELETE "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/callbacks" \
-H "Authorization: Bearer $ACCESS_TOKEN"Path parameters
| Name | Type | Description |
|---|---|---|
bot_id | UUID | The bot's avatar UUID (agentId from GET /bots). |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
url | string | no | Webhook URL to change. |
events | string | no | Comma-separated events to unsubscribe. |
Body
None — send an empty body.
Example response
{
"success": true,
"data": {
"result": "OK"
},
"meta": {
"timestamp": "2026-10-02T12:00:00.000Z",
"version": "1.0"
}
} Always check success; for commands the bot carries out, also check data.result. See Responses & errors.