Skip to content
Last updated

Delete a custom role from an organization. System roles cannot be deleted. Roles with active members must have their members reassigned first. Requires the manage_roles capability.

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/roles/{role_id}

Path Parameters

organization_id string required

Organization ID (org_ prefixed string).

role_id string required

Role ID (role_ prefixed string). Must be a custom role with no active members.


Returns

No content on success (204).

cURL
curl -X DELETE "https://api.aitronos.com/v1/organizations/org_abc123/roles/role_xyz789" \
  -H "Authorization: Bearer $ACCESS_TOKEN"