Auth API reference

Auth API · Consumer-Admin-Roles

delete/{app_slug}/v1/admin/roles/{role_name}Auth

Delete a custom role

System roles (`owner`, `admin`, `member`) cannot be deleted — attempts return 403. Roles currently assigned to any member return 409 `ROLE_IN_USE`; reassign the affected members first.

Path parameters

app_slug*string

Slug of the app.

role_name*string

Name of the role (e.g. `admin`).

Response · 204

Role deleted.

Example

Request

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