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
curl -X DELETE https://api.eu.keenauth.com/v1/permissions/perm_01h455vb4pex5vsknk084sn02s \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"