DELETE /dispositions/{disposition_id}
Permanently deletes a disposition. This also removes the disposition’s link to any agents it was associated with.
Deletion is permanent and cannot be undone. Historical call execution results that already contain this disposition’s output are not affected — only future calls will stop evaluating it.
Path Parameters
| Parameter | Type | Required | Description |
|---|
disposition_id | UUID | Yes | The ID of the disposition to delete |
Authorization
- Regular users can only delete dispositions they own (
created_by matches their user ID).
- Admins can delete any disposition.
Response
200 OK
{
"message": "Disposition deleted successfully",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Example
curl --request DELETE \
--url 'https://api.bolna.dev/dispositions/{disposition_id}' \
--header 'Authorization: Bearer {api_key}'
Error Responses
| Status | Description |
|---|
403 | Access denied — you do not own this disposition |
404 | Disposition not found |
500 | Internal server error |
