Group Update

Description: Updates an Access group's external ID, description, and other parameters. To add or remove users, use the Add or Remove User from Groups REST API instead.

Note

This REST API is part of the New Security REST APIs, where modifying the realm and realm attributes parameters is not supported.

Since: 7.49.3

Authorization: Requires admin authentication using Access Tokens

Usage: PATCH /access/api/v2/groups/{name}

Produces: application/json

Note

All fields are optional; if a field is not specified, the value will not change (if the request payload is empty, returns 200)

Request:

{
  "description": "string",
  "auto_join": boolean,
  "admin_privileges": boolean,
  "external_id": "string"
  "watch_manager": false, # this parameter is only available starting from Artifactory version 7.128.0
  "policy_viewer": false, # this parameter is only available starting from Artifactory version 7.128.0
  "policy_manager": false, # this parameter is only available starting from Artifactory version 7.128.0
  "reports_manager": false, # this parameter is only available starting from Artifactory version 7.128.0
  "resources_manager": false # this parameter is only available starting from Artifactory version 7.128.0
}

Response:

{
  "name": "string",
  "description": "string",
  "auto_join": false,
  "admin_privileges": false,
  "external_id": "string",
  "members": ["user1", "user2"]
  "watch_manager": false, # this parameter is only available starting from Artifactory version 7.128.0
  "policy_viewer": false, # this parameter is only available starting from Artifactory version 7.128.0
  "policy_manager": false, # this parameter is only available starting from Artifactory version 7.128.0
  "reports_manager": false, # this parameter is only available starting from Artifactory version 7.128.0
  "resources_manager": false # this parameter is only available starting from Artifactory version 7.128.0
}

Response Codes:

201: Successful
400: Invalid input, object invalid
401: Invalid credentials
403: Insufficient permissions
404: Name not found