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

# Delete a persona

> Deletes a persona.

Searches already running keep the settings they started with.

### Path parameters

**persona\_id** `string` *required*

The persona's `id`.

### Response

**`204`** The persona was deleted. The response has no body.

### Errors

| Status | Code | When |
| - | - | - |
| `401` | `invalid_api_key` | The API key is missing, invalid or revoked. |
| `404` | `not_found` | No such object in this workspace. |
| `429` | `rate_limited` | Too many requests. Retry after `Retry-After` seconds. |
| `500` | `internal_error` | Something went wrong on our side. Retry with backoff, and with the same `Idempotency-Key` if you sent one. |

Every error uses the same shape. See [Errors](https://docs.data.avina.io/api-reference/errors.md).

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X DELETE https://api.avina.io/v1/personas/$PERSONA_ID \
  -H "Authorization: Bearer $AVINA_API_KEY"
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import os
import requests

response = requests.delete(
    f"https://api.avina.io/v1/personas/{persona_id}",
    headers={"Authorization": f"Bearer {os.environ['AVINA_API_KEY']}"},
)
response.raise_for_status()
print(response.status_code)
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const response = await fetch(`https://api.avina.io/v1/personas/${personaId}`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.AVINA_API_KEY}`,
  },
});
console.log(response.status);
```

```json 401 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key is invalid or revoked.",
    "request_id": "req_8f2a61c09d4e7b3a5f10c2d8"
  }
}
```


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