---
title: "Request access to a team"
method: POST
path: "/v1/teams/{teamId}/request"
tags: ["teams"]
---

# Request access to a team

`POST /v1/teams/{teamId}/request`

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

## Path parameters

- `teamId` string, required — The unique team identifier

## Request body

- object
  - `joinedFrom` object, required
    - `origin` 'import' | 'teams' | 'github' | 'gitlab' | 'bitbucket' | 'feedback' | 'organization-teams', required — The origin of the request.
    - `commitId` string — The commit sha if the origin is a git provider.
    - `repoId` string — The ID of the repository for the given Git provider.
    - `repoPath` string — The path to the repository for the given Git provider.
    - `gitUserId` union — The ID of the Git account of the user who requests access.
      - string
      - number
    - `gitUserLogin` string — The login name for the Git account of the user who requests access.

## Response `200`

Successfuly requested access to the team.

- object
  - `teamSlug` string, required
  - `teamName` string, required
  - `confirmed` false | true
  - `joinedFrom` object
    - `origin` 'account-update' | 'bitbucket' | 'dsync' | 'feedback' | 'github' | 'gitlab' | 'import' | 'link' | 'mail' | 'nsnb-auto-approve' | 'nsnb-hobby-upgrade' | 'nsnb-invite' | 'nsnb-redeploy' | 'nsnb-redeploy-attribution-card' | 'nsnb-request-access' | 'nsnb-viewer-upgrade' | 'organization-teams' | 'saml' | 'teams', required
    - `commitId` string
    - `repoId` string
    - `repoPath` string
    - `gitUserId` union
      - string
      - number
    - `gitUserLogin` string
    - `ssoUserId` string
    - `ssoConnectedAt` number
    - `idpUserId` string
    - `dsyncUserId` string
    - `dsyncConnectedAt` number
  - `accessRequestedAt` number
  - `github` object, nullable, required
    - `login` string
  - `gitlab` object, nullable, required
    - `login` string
  - `bitbucket` object, nullable, required
    - `login` string

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401`
- `403` — You do not have permission to access this resource.
- `404` — The team was not found.
- `410`
- `429`
- `503`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)