Create a Group

Creates a new group.

By default the group is created in the internal realm. To import an
LDAP group, set import_from_ldap_group_setting to the name of the LDAP
group setting that covers it and name to the group's name in the
directory. The directory matches name with its own comparison rule
for the group name attribute, which ignores case for cn and the other
standard name attributes; on a directory that compares names exactly,
use the group name exactly as the directory spells it. The group is
created in the ldap realm under the directory's name in lowercase, the
same as a group imported from the LDAP Groups screen. LDAP login keeps
its members in sync with the directory. members
cannot be set together with import_from_ldap_group_setting. To import
every group of an LDAP group setting at once, use the Refresh LDAP Group
Settings API.

Security: Requires admin privileges.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The group name (required)

string

Group description

boolean
Defaults to false

Whether new users auto-join this group

boolean
Defaults to false

Whether group has admin privileges

string

External ID for SCIM

string

Name of an LDAP group setting to import the group from. The group whose name attribute equals name is looked up in the directory of that setting, using the directory's comparison rule for that attribute (case-insensitive for cn and the other standard name attributes), and created in the ldap realm. LDAP group names are imported in lowercase, so the created group can be named differently from the request (for example devops for DevOps); the response has the created name. The name must identify a single group. Cannot be combined with members; LDAP login manages the members.

members
array of strings

Initial group members

members
boolean
Defaults to false

Whether group has reports manager role. Available from Artifactory 7.128.0.

boolean
Defaults to false

Whether group has watch manager role. Available from Artifactory 7.128.0.

boolean
Defaults to false

Whether group has policy manager role. Available from Artifactory 7.128.0.

boolean
Defaults to false

Whether group has policy viewer role. Available from Artifactory 7.128.0.

boolean
Defaults to false

Whether group manages resources in the default project. Available from Artifactory 7.128.0.

boolean
Defaults to false

Whether group has manage webhook permissions. Available from Artifactory 7.128.0.

Responses

400

Bad Request - Invalid input

401

Bad Credentials - Invalid credentials

403

Permission Denied - Insufficient permissions

404

Not Found - One or more users in members were not found, or, when importing an LDAP group, the LDAP group setting or the group in the directory was not found

409

Conflict - Group already exists

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Choose an example:
application/json