Permissions

Delete a role

Delete a role — only ever a company-authored or a global one.

The full matrix, and why nothing here is a confirmable 409, is in permissions_db.delete_platform_role_guarded. In short: a template deleted from here has no repair path through the product, a system copy comes back under a new id at the next invite, and deleting a HELD role is a company lockout rather than an escalation — get_effective_modules INNER JOINs Z_Roles, so the survivors resolve to the empty set.

delete/api/roles/{role_id}

Path parameters

role_idinteger required

Headers

x-api-tokenstring nullable

Response

Successful Response

{"stackTrail":"paths:/api/roles/{role_id}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.