v2

latestOpenAPI 3.0.32026-07-261513102.9 KB

Role Management

Update a custom role

Updates custom role metadata, permissions, or default status. System roles are immutable. Omitting is_default preserves the current default status; true clears any previous default; false unsets this role as default.

patch/v1/roles/{roleId}

Path parameters

roleIdstring required

Request body

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.

namestring

descriptionstring nullable

is_defaultboolean

Response

Custom role updated