Edit a Global Role

put

https://{jfrog_url}/access/api/v1/roles/{role}

Update an existing global role.

Security: Requires admin privileges.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

role

string

required

The role name

Body Params

Request body matches the Role resource model. name must match the {role} path segment. type must match the role's current type (unchanged on edit). Other fields are optional; send description, environments, and actions only when updating those aspects.

name

string

required

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

description

string

type

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

Loading…