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 and receive a deletion confirmation in the response.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
role_idstringrequired
The identifier of the custom organization role to delete.
200Returns a deletion confirmation containing the deleted role's identifier and a boolean `deleted` value.
objectstringrequired
Always `role.deleted`.
idstringrequired
Identifier of the deleted role.
deletedbooleanrequired
Whether the role was deleted.
429Returned when the request was rejected because the rate limit was exceeded.
errorobjectrequired
Error handling
A 429 is returned when the request exceeds the rate limit. role_id must identify the custom organization role you want to delete.