DELETE
/organization/roles/{role_id}Delete an organization role
Deletes a custom role from the organization. Use role_id to identify the role to remove. The response confirms whether the role was deleted and includes its identifier.
role_idstringrequired
The unique identifier of the role to delete.
200Returns a deletion confirmation containing the deleted role's identifier and a `deleted` flag.
objectstringrequired
Always `role.deleted`.
idstringrequired
Identifier of the deleted role.
deletedbooleanrequired
Whether the role was deleted.
400Returned when the request parameters are invalid or the requested operation cannot be performed.
errorobjectrequired
403Returned when the caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
404Returned when the endpoint is unavailable or a requested resource is not found in the organization or project.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired
Error handling
A 400 is returned when the request parameters are invalid or the requested operation cannot be performed. A 403 is returned when the authenticated user does not have permission, a 404 when the endpoint is unavailable or a requested resource is not found, and a 429 when a rate limit is exceeded. The role_id path parameter identifies the role to delete.