Skip to content
Docs

Reads an access group

GEThttps://api.vercel.com/v1/access-groups/{idOrName}
Allows to read an access group
https://api.vercel.com/v1/access-groups/{idOrName}
const response = await fetch('https://api.vercel.com/v1/access-groups/idOrName?teamId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});


const data = await response.json();
console.log(data);
Response
{
  "accessGroupId": "ag_123a6c5209bc3778245d011443644c8d27dc2c50",
  "createdAt": "1588720733602",
  "entitlements": [],
  "isDsyncManaged": "false",
  "membersCount": "5",
  "name": "my-access-group",
  "projectsCount": "2",
  "teamId": "team_123a6c5209bc3778245d011443644c8d27dc2c50",
  "teamPermissions": [],
  "teamRoles": [],
  "updatedAt": "1588720733602"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

idOrNamestringRequired

Query parameters

teamIdstringOptional
The Team identifier to perform the request on behalf of.
slugstringOptional
The Team slug to perform the request on behalf of.

Response

200Success
accessGroupIdstringRequired
ID of the access group.
createdAtstringRequired
Timestamp in milliseconds when the access group was created.
entitlementsarrayOptional
isDsyncManagedbooleanRequired
membersCountnumberRequired
Number of members in the access group.
namestringRequired
The name of this access group.
projectsCountnumberRequired
Number of projects in the access group.
teamIdstringRequired
ID of the team that this access group belongs to.
teamPermissionsarrayOptional
teamRolesarrayOptional
Roles that the team has in the access group.
updatedAtstringRequired
Timestamp in milliseconds when the access group was last updated.

Errors

400One of the provided values in the request query is invalid.
401The request is not authorized.
403You do not have permission to access this resource.
404Error
410Error