vercel teams
The vercel teams command manages Teams: list teams you belong to, create a new team, switch between teams, invite Team Members, inspect SAML/SSO configuration, list or remove members, and check team join-request status.
vercel switch is a top-level alias for vercel teams switch.
vercel teams listUsing the vercel teams command to list all teams you're a member of.
List all teams you're a member of.
vercel teams list [options]| Option | Description |
|---|---|
--next | Show the next page of results. Pass the cursor that the previous page prints. |
--limit | Number of teams to return per page. The default is 20, and the maximum is 100. |
--json | Output the result as JSON. |
Show the next page, using the cursor that the previous page prints:
vercel teams list --next 1584722256178Create a new team. The interactive flow prompts for slug and display name; in non-interactive mode you must pass both --slug and --name.
vercel teams create [options]| Option | Description |
|---|---|
--slug | Team URL slug (for example, acme for vercel.com/acme). Required in non-interactive mode. |
--name | Display name for the team. Required in non-interactive mode. |
Create a team interactively:
vercel teams createCreate a team non-interactively:
vercel teams create --slug acme --name "Acme Corp"Invite one or more new members to the current team. In non-interactive mode you must pass at least one email address.
vercel teams invite [email...]Invite interactively:
vercel teams inviteInvite multiple members (required form in non-interactive mode):
vercel teams invite abc@vercel.com xyz@vercel.comSwitch your CLI context to a different team. If the slug is omitted, the command is interactive. Available as the top-level alias vercel switch.
switch does not accept the global --token flag; use the global --scope flag if you need to override scope for a single command.
vercel teams switch [slug]Switch to a team by slug (if your team's URL is vercel.com/name, then name is the slug):
vercel teams switch acmeSwitch interactively:
vercel teams switchShow the join-request status for the current team. Defaults to the authenticated user; pass a user ID to check another user's request.
vercel teams request [userId] [options]| Option | Description |
|---|---|
--json | Output the result as JSON. |
Status for your pending request:
vercel teams requestStatus for another user ID:
vercel teams request user_abc123Show the SAML/SSO configuration for the currently scoped team.
vercel teams sso [options]| Option | Description |
|---|---|
--json | Output the result as JSON. |
Human-readable SAML summary:
vercel teams ssoJSON output:
vercel teams sso --jsonList the members of the currently scoped team, or remove a member from it. To invite a member, use invite.
vercel teams members [options]
vercel teams members remove <member>To remove a member, pass their email, username, or user ID. The command shows the team and the member, then asks you to confirm. No option skips this prompt, so run the command in an interactive terminal. If the team's invoices go to that member, the command first asks you for a new invoice recipient.
| Option | Description |
|---|---|
--next | Show the next page of results. Pass the cursor that the previous page prints. |
--limit | Number of members to return per page. The default is 20, and the maximum is 100. |
--json | Output the result as JSON. |
# List team members
vercel teams members
# List team members as JSON
vercel teams members --json
# Paginate results
vercel teams members --next 1584722256178
# Remove a member
vercel teams members remove user@example.comThe following global options can be passed when using the vercel teams command:
For more information on global options and their usage, refer to the options section.
Was this helpful?