Sign in

v14

latestOpenAPI 3.0.32026-08-04377889.4 MB
access-groups

Creates an access group

Allows to create an access group

post/v1/access-groups

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

namestring required

The name of the access group

membersToAddstring[]

List of members to add to the access group.

Example request

{
  "name": "My access group",
  "projects": [
    {
      "projectId": "prj_ndlgr43fadlPyCtREAqxxdyFK",
      "role": "ADMIN"
    }
  ],
  "membersToAdd": [
    "usr_1a2b3c4d5e6f7g8h9i0j",
    "usr_2b3c4d5e6f7g8h9i0j1k"
  ]
}

Response

entitlementsstring[] required
membersCountnumber required
projectsCountnumber required
namestring required

The name of this access group.

createdAtstring required

Timestamp in milliseconds when the access group was created.

teamIdstring required

ID of the team that this access group belongs to.

updatedAtstring required

Timestamp in milliseconds when the access group was last updated.

accessGroupIdstring required

ID of the access group.

teamRolesstring[]

Roles that the team has in the access group.

teamPermissionsstring[]

Permissions that the team has in the access group.

Example response

{
  "name": "my-access-group",
  "teamId": "team_123a6c5209bc3778245d011443644c8d27dc2c50",
  "accessGroupId": "ag_123a6c5209bc3778245d011443644c8d27dc2c50",
  "teamRoles": [
    "DEVELOPER",
    "BILLING"
  ],
  "teamPermissions": [
    "CreateProject"
  ]
}