Sign in

v13

latestOpenAPI 3.0.32026-07-31359869.4 MB
access-groups

Update an access group

Allows to update an access group metadata

post/v1/access-groups/{idOrName}

Path parameters

idOrNamestring required

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

The name of the access group

membersToAddstring[]

List of members to add to the access group.

membersToRemovestring[]

List of members to remove from the access group.

Example request

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

Response

entitlementsstring[] 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.

membersCountnumber required

Number of members in the access group.

projectsCountnumber required

Number of projects in 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",
  "membersCount": 5,
  "projectsCount": 2,
  "teamRoles": [
    "DEVELOPER",
    "BILLING"
  ],
  "teamPermissions": [
    "CreateProject"
  ]
}