Meeting BaaSMeeting BaaS
Meeting BaaS API v2Typescript SDKMCP ServersSpeaking BotsSelf HostingBring Your Own StorageMeeting BaaS API v1 (legacy)

API v2/DELETE

Delete bot data

Permanently delete all bot data including recordings, transcripts, summaries, and screenshots.

This operation is irreversible. All artifacts (video, audio, transcription, diarization, screenshots) will be permanently deleted. Optionally delete transcription data from the transcription provider as well using the delete_transcription query parameter.

Data Deletion:

  • All artifacts (video, audio, transcription, diarization, screenshots) are permanently deleted
  • The artifacts_deleted field is set to true
  • Artifact URLs will return null in subsequent API calls
  • Bot metadata remains accessible but all associated data is removed

Transcription Provider Deletion: If delete_transcription=true is provided, the transcription data will also be deleted from the transcription provider. This requires the bot to have transcription enabled and a transcription provider configured. If the bot uses BYOK transcription, you must have access to the transcription provider API key.

Irreversible Operation: Once data is deleted, it cannot be recovered. Make sure you have downloaded or backed up any data you need before calling this endpoint.

Status Requirements: The bot must be in completed or failed status. Bots that are still in progress (queued, joining, in_call_recording, transcribing) cannot have their data deleted. If the bot is in an invalid state, the request will fail with a 409 Conflict status.

Returns 404 if the bot is not found, or 409 if the bot's status does not allow this operation.

DELETE
/v2/bots/{bot_id}/delete-data

Authorization

ApiKeyAuth
x-meeting-baas-api-key<token>

Your Meeting BaaS API key. Get one from your account settings.

In: header

Path Parameters

bot_id*string

The UUID of the bot whose data should be deleted.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Query Parameters

delete_from_provider*boolean

Whether to delete transcription data from the transcription provider.

If true (default), the transcription data will be deleted from the transcription provider's servers in addition to deleting artifacts from S3. This ensures complete data deletion.

If false, only S3 artifacts will be deleted, and transcription data will remain on the transcription provider's servers.

Note: If the bot was created with a BYOK (Bring Your Own Key) transcription API key, the deletion will use that key to authenticate with the transcription provider.

Default: true

Defaulttrue

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://api.meetingbaas.com/v2/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/delete-data?delete_from_provider=true"
{
  "data": {
    "message": "string"
  },
  "success": true
}
{
  "code": "string",
  "error": "string",
  "message": "string",
  "statusCode": 9007199254740991,
  "success": false
}
{
  "code": "string",
  "details": "string",
  "error": "string",
  "message": "string",
  "statusCode": 9007199254740991,
  "success": false
}
{
  "code": "string",
  "details": "string",
  "error": "string",
  "message": "string",
  "retryAfter": 9007199254740991,
  "statusCode": 9007199254740991,
  "success": false
}
{
  "code": "string",
  "details": "string",
  "error": "string",
  "message": "string",
  "statusCode": 9007199254740991,
  "success": false
}
Edit on GitHub