Removing a Bot

Overview

When you need to end a bot's participation in a meeting, you can use the API to remove it immediately. This is useful for:

• Ending recordings early
• Freeing up bot resources
• Responding to meeting conclusion

API Request

Send a DELETE request to https://api.meetingbaas.com/bots/{YOUR_BOT_ID}:

curl -X DELETE "https://api.meetingbaas.com/bots/YOUR_BOT_ID" \
     -H "Content-Type: application/json" \
     -H "x-meeting-baas-api-key: YOUR-API-KEY"

Required Parameters

• Path Parameter: bot_id - The unique identifier received when sending the bot
• Header: x-meeting-baas-api-key - Your API key for authentication

Both parameters are mandatory for the request to succeed.

Response

The API will respond with a simple confirmation:

HTTP/2 200
Content-Type: application/json
 
{ "ok": true }

What Happens Next

When a bot is removed:

1. The bot leaves the meeting immediately
2. A call_ended status event is sent to your webhook
3. The final meeting data up to that point is delivered

For more details about these webhook events, see Getting the Data.