> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Persona

> Delete a persona.

> [!WARNING]
>
> 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.

**deletion result**

**success** `boolean`

Whether the deletion was successful.

**message** `string`

Confirmation message about the deletion.

**errors** `string`

Any errors that occurred (null if none).

```json Success Response theme={null}
{
  "data": {
    "success": true,
    "message": "Persona deleted successfully"
  },
  "errors": null
}
```

```json Error Response (Persona in Use) theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "PERSONA_IN_USE",
      "message": "Cannot delete persona that is currently in use by phone numbers",
      "details": {
        "persona_id": "12345678-1234-1234-1234-123456789012",
        "phone_numbers_using": [
          "+15551234567",
          "+15551234568"
        ],
        "suggestion": "Remove persona from all phone numbers first, or use force=true parameter"
      }
    }
  ]
}
```

```json Error Response (Not Found) theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "PERSONA_NOT_FOUND",
      "message": "Persona not found",
      "details": {
        "persona_id": "12345678-1234-1234-1234-123456789012"
      }
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.