Reference
post/v1/access-groups

Allows to create an access group

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"body": {
3
"name": "My access group",
4
"membersToAdd": "SOME_ARRAY OF STRING_VALUE",
5
"projects": [
6
{
7
"projectId": "prj_ndlgr43fadlPyCtREAqxxdyFK",
8
"role": "ADMIN"
9
}
10
]
11
},
12
"headers": {
13
"Authorization": "Bearer <TOKEN>"
14
},
15
"method": "post"
16
})
Query Params
Body Params
Query ParameterDescription

slug

string

The Team slug to perform the request on behalf of.

teamId

string

The Team identifier to perform the request on behalf of.
  • accessGroupIdstringRequired
    ID of the access group.

    Example: ag_123a6c5209bc3778245d011443644c8d27dc2c50

  • createdAtstringRequired
    Timestamp in milliseconds when the access group was created.

    Example: 1588720733602

  • membersCountnumberRequired
  • namestringRequired
    The name of this access group.

    Example: my-access-group

  • projectsCountnumberRequired
  • teamIdstringRequired
    ID of the team that this access group belongs to.

    Example: team_123a6c5209bc3778245d011443644c8d27dc2c50

  • updatedAtstringRequired
    Timestamp in milliseconds when the access group was last updated.

    Example: 1588720733602

CodeDescription
200
400One of the provided values in the request body is invalid.
401
403You do not have permission to access this resource.
404
post/v1/access-groups/{accessGroupIdOrName}/projects

Allows creation of an access group project

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/SOME_STRING_VALUE/projects?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"body": {
3
"projectId": "prj_ndlgr43fadlPyCtREAqxxdyFK",
4
"role": "ADMIN"
5
},
6
"headers": {
7
"Authorization": "Bearer <TOKEN>"
8
},
9
"method": "post"
10
})
Path Params
Query Params
Body Params
Path ParameterDescription

accessGroupIdOrName

string

required
  • accessGroupIdstringRequired
  • createdAtstringRequired
  • projectIdstringRequired
  • rolestringRequired
    One of: ADMIN | PROJECT_DEVELOPER | PROJECT_VIEWER
  • teamIdstringRequired
  • updatedAtstringRequired
CodeDescription
200
400
  • One of the provided values in the request body is invalid.

  • One of the provided values in the request query is invalid.

401
403You do not have permission to access this resource.
404
delete/v1/access-groups/{idOrName}

Allows to delete an access group

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "delete"
6
})
Path Params
Query Params
Path ParameterDescription

idOrName

string

required
N/A
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
delete/v1/access-groups/{accessGroupIdOrName}/projects/{projectId}

Allows deletion of an access group project

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/SOME_STRING_VALUE/projects/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "delete"
6
})
Path Params
Query Params
Path ParameterDescription

accessGroupIdOrName

string

required

projectId

string

required
N/A
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
get/v1/access-groups/{idOrName}/members

List members of an access group

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/ag_pavWOn1iLObbXLRiwVvzmPrTWyTf/members?limit=20&next=SOME_STRING_VALUE&search=SOME_STRING_VALUE&slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "get"
6
})
Path Params
Query Params
Path ParameterDescription

idOrName

string

required
The ID or name of the Access Group.
Example:ag_pavWOn1iLObbXLRiwVvzmPrTWyTf
  • membersarrayRequired
  • Properties
  • paginationobjectRequired
  • Properties
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
get/v1/access-groups/{idOrName}/projects

List projects of an access group

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/ag_pavWOn1iLObbXLRiwVvzmPrTWyTf/projects?limit=20&next=SOME_STRING_VALUE&slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "get"
6
})
Path Params
Query Params
Path ParameterDescription

idOrName

string

required
The ID or name of the Access Group.
Example:ag_pavWOn1iLObbXLRiwVvzmPrTWyTf
  • paginationobjectRequired
  • Properties
  • projectsarrayRequired
  • Properties
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
get/v1/access-groups

List access groups

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups?limit=20&membersLimit=20&next=SOME_STRING_VALUE&projectId=prj_pavWOn1iLObbx3RowVvzmPrTWyTf&projectsLimit=20&search=example&slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "get"
6
})
Query Params
Query ParameterDescription

limit

integer

Limit how many access group should be returned.
>=1<=100
Example:20

membersLimit

integer

Number of members to include in the response.
>=1<=100
Example:20

next

string

Continuation cursor to retrieve the next page of results.

projectId

string

Filter access groups by project.
Example:prj_pavWOn1iLObbx3RowVvzmPrTWyTf

projectsLimit

integer

Number of projects to include in the response.
>=1<=100
Example:20

search

string

Search for access groups by name.
Example:example

slug

string

The Team slug to perform the request on behalf of.

teamId

string

The Team identifier to perform the request on behalf of.
  • One of the following objects
  • One of
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
get/v1/access-groups/{idOrName}

Allows to read an access group

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "get"
6
})
Path Params
Query Params
Path ParameterDescription

idOrName

string

required
  • accessGroupIdstringRequired
    ID of the access group.

    Example: ag_123a6c5209bc3778245d011443644c8d27dc2c50

  • createdAtstringRequired
    Timestamp in milliseconds when the access group was created.

    Example: 1588720733602

  • entitlementsarray
  • isDsyncManagedbooleanRequired
  • membersCountnumberRequired
    Number of members in the access group.

    Example: 5

  • namestringRequired
    The name of this access group.

    Example: my-access-group

  • projectsCountnumberRequired
    Number of projects in the access group.

    Example: 2

  • teamIdstringRequired
    ID of the team that this access group belongs to.

    Example: team_123a6c5209bc3778245d011443644c8d27dc2c50

  • updatedAtstringRequired
    Timestamp in milliseconds when the access group was last updated.

    Example: 1588720733602

CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
get/v1/access-groups/{accessGroupIdOrName}/projects/{projectId}

Allows reading an access group project

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/SOME_STRING_VALUE/projects/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "get"
6
})
Path Params
Query Params
Path ParameterDescription

accessGroupIdOrName

string

required

projectId

string

required
  • accessGroupIdstringRequired
  • createdAtstringRequired
  • projectIdstringRequired
  • rolestringRequired
    One of: ADMIN | PROJECT_DEVELOPER | PROJECT_VIEWER
  • teamIdstringRequired
  • updatedAtstringRequired
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
post/v1/access-groups/{idOrName}

Allows to update an access group metadata

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"body": {
3
"membersToAdd": "SOME_ARRAY OF STRING_VALUE",
4
"membersToRemove": "SOME_ARRAY OF STRING_VALUE",
5
"name": "My access group",
6
"projects": [
7
{
8
"projectId": "prj_ndlgr43fadlPyCtREAqxxdyFK",
9
"role": "ADMIN"
10
}
11
]
12
},
13
"headers": {
14
"Authorization": "Bearer <TOKEN>"
15
},
16
"method": "post"
17
})
Path Params
Query Params
Body Params
Path ParameterDescription

idOrName

string

required
  • accessGroupIdstringRequired
    ID of the access group.

    Example: ag_123a6c5209bc3778245d011443644c8d27dc2c50

  • createdAtstringRequired
    Timestamp in milliseconds when the access group was created.

    Example: 1588720733602

  • entitlementsarray
  • membersCountnumberRequired
    Number of members in the access group.

    Example: 5

  • namestringRequired
    The name of this access group.

    Example: my-access-group

  • projectsCountnumberRequired
    Number of projects in the access group.

    Example: 2

  • teamIdstringRequired
    ID of the team that this access group belongs to.

    Example: team_123a6c5209bc3778245d011443644c8d27dc2c50

  • updatedAtstringRequired
    Timestamp in milliseconds when the access group was last updated.

    Example: 1588720733602

CodeDescription
200
400
  • One of the provided values in the request body is invalid.

  • One of the provided values in the request query is invalid.

401
403You do not have permission to access this resource.
404
patch/v1/access-groups/{accessGroupIdOrName}/projects/{projectId}

Allows update of an access group project

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v1/access-groups/SOME_STRING_VALUE/projects/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"body": {
3
"role": "ADMIN"
4
},
5
"headers": {
6
"Authorization": "Bearer <TOKEN>"
7
},
8
"method": "patch"
9
})
Path Params
Query Params
Body Params
Path ParameterDescription

accessGroupIdOrName

string

required

projectId

string

required
  • accessGroupIdstringRequired
  • createdAtstringRequired
  • projectIdstringRequired
  • rolestringRequired
    One of: ADMIN | PROJECT_DEVELOPER | PROJECT_VIEWER
  • teamIdstringRequired
  • updatedAtstringRequired
CodeDescription
200
400
  • One of the provided values in the request body is invalid.

  • One of the provided values in the request query is invalid.

401
403You do not have permission to access this resource.
404
Last updated on November 21, 2024