Skip to main content
DELETE
/
v1
/
experts
/
{expert_id}
Delete Expert
curl --request DELETE \
  --url https://api.b-bot.space/api/v2/v1/experts/{expert_id} \
  --header 'bbot-api-key: <api-key>' \
  --header 'bbot_api_key: <bbot_api_key>'
{
  "id": "<string>",
  "message": "<string>"
}
Permission Required: This endpoint is only available for Agencies and Middleware Partners.This action is irreversible. All expert data, configurations, and associations will be permanently deleted.

​
What Gets Deleted

When you delete an expert, the following data is permanently removed:
  • Expert configuration and metadata
  • Associated abilities and templates
  • App connections and credentials
  • Knowledge container associations
  • Team member relationships
  • Profile picture references
  • Task assistant linkages
Note: Deleting an expert does NOT delete:
  • Distribution channels (assistants) created from the expert
  • Chat history or conversation threads
  • Uploaded files in knowledge containers (they become orphaned)
  • Users or other experts

Authorizations

​
bbot-api-key
string
header
required

API key for authentication

Headers

​
bbot_api_key
string
required

API Key for authentication

Path Parameters

​
expert_id
string
required

The unique identifier of the expert to delete

Response

Success

​
id
string

Deleted expert ID

​
message
string

Confirmation message