Skip to main content
DELETE
/
calendar
/
scheduled
/
{bot_id}
Delete Scheduled Bot
curl --request DELETE \
  --url https://api.meestream.ai/api/v1/calendar/scheduled/{bot_id} \
  --header 'Authorization: <api-key>'
{
  "message": "<string>",
  "bot_id": "<string>"
}

Overview

Deletes a specific scheduled bot by bot_id. Cancels the EventBridge schedule and removes the bot from the system. Cannot delete active bots that are currently in a meeting.

Request

Endpoint: DELETE /calendar/scheduled/{bot_id} or DELETE /calendar/schedule/{bot_id} Headers:
Authorization: Token <api_key>
Path Parameters:
ParameterTypeRequiredDescription
bot_idstringYesThe BotID of the scheduled bot
Request Body: None required

Response

Success Response (200)

{
  "message": "Scheduled bot deleted successfully",
  "bot_id": "uuid"
}

Response Fields

FieldTypeDescription
messagestringSuccess message
bot_idstringThe bot ID that was deleted

Error Responses

400 Bad Request

  • Missing bot_id
  • Bot is not scheduled
  • Cannot delete active bot (bot is currently in a meeting)

401 Unauthorized

Missing user_id in token or invalid authentication.

403 Forbidden

Bot does not belong to the authenticated user.

404 Not Found

Bot not found.

500 Internal Server Error

An error occurred while deleting the bot.

Usage Example

DELETE /calendar/scheduled/5b0ff6e7-3cea-4c9f-a6b4-851c5f11cf4f
You cannot delete a bot that is currently active (status: “InMeeting”). Wait for the bot to leave the meeting or stop it first.

Authorizations

Authorization
string
header
required

All API endpoints are authenticated using API Keys. The key should be included in the 'Authorization' header, prefixed with 'Token '. Example: 'Authorization: Token YOUR_API_KEY'.

Path Parameters

bot_id
string
required

The BotID of the scheduled bot.

Response

Scheduled bot deleted successfully.

message
string
required

Success message

bot_id
string
required

The bot ID that was deleted