DELETE
/
v1
/
personas
/
{persona_id}
Delete Persona
curl --request DELETE \
  --url https://api.bland.ai/v1/personas/{persona_id} \
  --header 'authorization: <authorization>'
{
  "data": {
    "success": true,
    "message": "Persona deleted successfully"
  },
  "errors": null
}
Deleting a persona will remove all versions and configuration data permanently. Any phone numbers currently using this persona will need to be reconfigured with a different persona or direct configuration.

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

persona_id
string
required
The unique identifier of the persona to delete.

Query Parameters

force
boolean
default:"false"
Force deletion even if persona is currently in use by phone numbers. When false, deletion will fail if persona is actively being used.

Response

data
object
The deletion result object.
errors
string
Any errors that occurred (null if none).
{
  "data": {
    "success": true,
    "message": "Persona deleted successfully"
  },
  "errors": null
}