Skip to main content

request

Creates, updates, deletes, gets or lists a request resource.

Overview

Namerequest
TypeResource
Idvercel.teams.request

Fields

The following fields are returned by SELECT queries:

Successfully

NameDatatypeDescription
accessRequestedAtnumberTimestamp in milliseconds when the user requested access to the team.
bitbucketobjectMap of the connected Bitbucket account.
confirmedbooleanCurrent status of the membership. Will be true if confirmed, if pending it'll be false.
githubobjectMap of the connected GitHub account.
gitlabobjectMap of the connected GitLab account.
joinedFromobjectA map that describes the origin from where the user joined.
teamNamestringThe name of the team. (example: My Team)
teamSlugstringThe slug of the team. (example: my-team)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_team_access_requestselectteamId, userIdCheck the status of a join request. It'll respond with a 404 if the request has been declined. If no userId path segment was provided, this endpoint will instead return the status of the authenticated user.
request_access_to_teamexecteamId, joinedFromRequest access to a team as a member. An owner has to approve the request. Only 10 users can request access to a team at the same time.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
teamIdstringID of the Team.
userIdstringUser ID.

SELECT examples

Check the status of a join request. It'll respond with a 404 if the request has been declined. If no userId path segment was provided, this endpoint will instead return the status of the authenticated user.

SELECT
accessRequestedAt,
bitbucket,
confirmed,
github,
gitlab,
joinedFrom,
teamName,
teamSlug
FROM vercel.teams.request
WHERE teamId = '{{ teamId }}' -- required
AND userId = '{{ userId }}' -- required
;

Lifecycle Methods

Request access to a team as a member. An owner has to approve the request. Only 10 users can request access to a team at the same time.

EXEC vercel.teams.request.request_access_to_team 
@teamId='{{ teamId }}' --required
@@json=
'{
"joinedFrom": "{{ joinedFrom }}"
}'
;