Skip to main content
GET
/
bots
/
{bot_id}
/
delete_data
Delete Bot Data
curl --request GET \
  --url https://api.meestream.ai/v1/bots/{bot_id}/delete_data \
  --header 'Authorization: <api-key>'
{
  "success": true,
  "message": "<string>"
}

​
Overview

This endpoint permanently deletes all data associated with a specific bot, including:
  • Audio recordings
  • Video recordings
  • Transcripts
  • Screenshots
  • Chat logs
  • Participant information
  • Bot metadata

​
Important Considerations

This action is irreversible. Once data is deleted, it cannot be recovered. Make sure you have downloaded any files you need before calling this endpoint.

​
Use Cases

  • Compliance: Meet data retention policies by removing meeting data after a specified period
  • Privacy: Delete sensitive meeting data upon user request
  • Storage Management: Free up storage space by removing old or unnecessary recordings
  • Testing: Clean up test bot data during development

​
Best Practices

  1. Download First: Always download and backup any required files (audio, video, transcripts) before deleting
  2. Verify Bot ID: Double-check the bot_id to ensure you’re deleting the correct bot’s data
  3. Audit Trail: Log deletion actions for compliance and audit purposes
  4. User Confirmation: Implement user confirmation in your application before calling this endpoint

​
Deletion Process

When you call this endpoint:
  1. All associated files are permanently removed from storage
  2. Database records for the bot are deleted
  3. The bot_id becomes invalid for future queries
  4. A success response is returned confirming deletion

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 unique identifier of the bot.

Response

Data deleted successfully.

​
success
boolean
required

Whether the deletion was successful

​
message
string
required

Confirmation message