Skip to main content

​
Endpoint

POST /api/v1/bots/{object_id}/delete_data

​
Authentication

Requires API key authentication via the Authorization header.
​
Authorization
string
required
Your API key in the format: Token YOUR_API_KEY_HERE
​
Content-Type
string
required
Must be application/json

​
Path Parameters

​
object_id
string
required
The unique identifier for the bot.Example: bot_xxxxxxxxxxx

​
Description

Permanently deletes all data associated with this bot, including:
  • Recordings
  • Transcripts
  • Participant information
  • Chat messages
  • Any other meeting data captured by the bot
This action cannot be undone. The bot’s metadata will not be deleted and the bot object will remain accessible, but all captured meeting data will be permanently removed.
After deletion, the bot’s state will change to data_deleted. You can still retrieve the bot object and its metadata, but all meeting content will be gone.

​
Response

Returns the bot object with updated state.
​
id
string
Unique identifier for the bot.
​
meeting_url
string
The URL of the meeting.
​
state
string
Current state of the bot (data_deleted after successful deletion).
​
events
array
Array of events that have occurred for this bot.
​
transcription_state
string
Current transcription state.
​
recording_state
string
Current recording state.
​
join_at
string
ISO 8601 timestamp when the bot joined the meeting.
​
deduplication_key
string
Deduplication key for the bot.
​
metadata
object
Custom metadata associated with the bot (this is preserved after data deletion).

​
Example Request

curl -X POST 'https://api.attendee.dev/api/v1/bots/bot_weIAju4OXNZkDTpZ/delete_data' \
  -H 'Authorization: Token YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json'

​
Example Response

{
  "id": "bot_weIAju4OXNZkDTpZ",
  "meeting_url": "https://zoom.us/j/123?pwd=456",
  "state": "data_deleted",
  "events": [
    {
      "type": "join_requested",
      "sub_type": null,
      "created_at": "2024-01-18T12:34:56Z"
    },
    {
      "type": "joined_meeting",
      "sub_type": null,
      "created_at": "2024-01-18T12:35:00Z"
    },
    {
      "type": "data_deleted",
      "sub_type": null,
      "created_at": "2024-01-18T14:00:00Z"
    }
  ],
  "transcription_state": "not_started",
  "recording_state": "not_started",
  "join_at": "2024-01-18T12:34:56Z",
  "deduplication_key": null,
  "metadata": {
    "customer_id": "abc123"
  }
}

​
Error Codes

  • 200 - Data successfully deleted
  • 400 - Bot is not in a valid state for data deletion (e.g., bot is still in a meeting)
  • 401 - Invalid or missing API key
  • 404 - Bot not found

Build docs developers (and LLMs) love

Get started for freeTalk to us