DELETE
/organization_roles/{organization_role_id}/permissions/{permission_id}Remove a permission from an organization role
Removes a permission from an organization role. Use the organization_role_id and permission_id path parameters to identify the role and permission to unlink. The response contains the updated role and its remaining permissions.
organization_role_idstringrequired
The unique identifier of the organization role to remove the permission from.
permission_idstringrequired
The unique identifier of the permission to remove.
200Returns the updated organization role, including its identifier, name, key, description, creator eligibility, remaining permissions, and creation and update timestamps.
objectstringrequired
idstringrequired
namestringrequired
keystringrequired
descriptionstringrequired
is_creator_eligiblebooleanrequired
Whether this role is eligible to be an organization creator role
permissionsarray<object>required
created_atintegerrequired
Unix timestamp of creation.
updated_atintegerrequired
Unix timestamp of last update.
401Returned when authentication is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Returned when the authenticated user is not authorized to remove the permission from the organization role.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the organization role or permission does not exist.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
422Returned when a request parameter is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
Error handling
A 401 is returned when authentication is invalid, and a 403 when the authenticated user is not authorized to remove the permission. A 404 is returned when the organization_role_id path parameter or permission_id path parameter does not identify an existing resource; a 422 is returned when a request parameter is invalid.