Auth API reference

Auth API · Consumer-Admin-Permissions

delete/{app_slug}/v1/admin/permissions/{permission_key}Auth

Delete a custom permission

The `permissionKey` path parameter is the literal `<resource>.<action>` string. System permissions cannot be deleted — attempts return 403. Removing a permission also removes every `role_permission` row that bound it (cascade); role lookups dropped of that perm on the next request.

Path parameters

app_slug*string

Slug of the app.

permission_key*string

Permission key, `resource.action` (e.g. `invoice.read`).

Response · 204

Permission deleted.

Example

Request

DELETE https://api.auth.productcraft.co/{app_slug}/v1/admin/permissions/{permission_key}
Authorization: Bearer YOUR_TOKEN