
# Delete a permission

`DELETE /v1/permissions/{permission_id}` · permission `apis:write`

Deletes a permission. It is also removed from the roles and application grants that contain it, and new tokens no longer carry it.

## Request

| Parameter | In | Description |
|---|---|---|
| `permission_id` | path | Permission ID (`perm_…`). |

## Response

`204 No Content`

## Errors

| HTTP | code | When |
|---|---|---|
| 403 | `insufficient_permissions` | The credential lacks `apis:write`. |
| 404 | `not_found` | There is no such permission in this environment. |
| 409 | `conflict` | The permission belongs to the system API. |

## Example

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/permissions/perm_01h455vb4pex5vsknk084sn02s \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```
