v2

latestOpenAPI 3.0.32026-07-261513102.9 KB

Role Management

Delete a custom role

Deletes an Enterprise custom role when it is not assigned to any organization members. System roles cannot be deleted.

delete/v1/roles/{roleId}

Path parameters

roleIdstring required

Query parameters

org_idstring

Required when authenticating with a workspace-scoped API token: the git-provider organization id to target within the token's workspace. Ignored for organization and self-hosted keys.

Response

Custom role deleted