Edit a Global Role

Update an existing global role.

Security: Requires admin privileges.

Path Params
string
required

The role name

Body Params
string
required

Role name; typically matches the {role} path parameter.

string
string
enum
required

Type for roles returned by this API. ADMIN is the Project Admin role; PREDEFINED is other built-in roles (e.g. Viewer); CUSTOM_GLOBAL is a user-defined global role. On PUT, the value must match the role's current type (the server rejects type changes).

Allowed:
environments
array of strings
environments
actions
array of strings

Permission actions as enum constant names (e.g. READ_REPOSITORY, MANAGE_MEMBERS).

actions
Responses
200

Role updated successfully.

400

Bad Request - Invalid input

401

Bad Credentials - Invalid credentials

403

Permission Denied - Insufficient permissions

404

Not Found - Role not found

Language
Credentials
Bearer
URL