vercel organizations

Use the vercel organizations command to create and manage organizations from the terminal. An organization groups several Edgenivo teams under one billing team, and the billing team pays for every team in the organization.

vercel organization is an alias for the same command. The command is available in [email protected] and later.

vercel organizations list
vercel organizations inspect acme
vercel organizations teams list acme

The vercel organizations command supports these subcommands:

• list: List the organizations you can view
• inspect: Show the details of an organization
• create: Create an organization from an existing team
• update: Change the slug of an organization
• teams list: List the teams in an organization
• teams create: Create a child team in an organization
• teams add: Add an existing team to an organization

Every subcommand except list and create acts on one organization. Pass the organization ID, which starts with org_, or the organization slug as the first argument. A slug matches the organizations that vercel organizations list shows. For any other organization, pass its ID.

vercel organizations inspect org_aBcD1234EfGh5678IjKl9012
vercel organizations inspect acme

When you omit the organization, the command uses the organization of the active team. Select the active team with the global --scope option. The billing team and every child team select the same organization.

vercel --scope acme-web organizations inspect

Use vercel organizations list to list the organizations you can view. The ls alias runs the same command.

vercel organizations list

The command prints a table with the ID, slug, billing team, and number of teams of each organization.

When more organizations exist than --limit allows, the command prints the vercel organizations list --next command that shows the next page.

Use vercel organizations inspect to show the details of an organization, including its billing team and its number of teams.

vercel organizations inspect acme

Use vercel organizations create to create an organization from the active team. The active team becomes the billing team of the organization, and you become the owner of the organization. The billing team must be an Enterprise team with Flexible Commitment (Flex) billing.

vercel --scope acme organizations create --slug acme --name "Acme Inc"

The organization exists when the command returns. Edgenivo then moves the projects of the billing team to the organization in the background.

Use vercel organizations update to change the slug of an organization.

vercel organizations update org_aBcD1234EfGh5678IjKl9012 --slug acme-corp

Use vercel organizations teams list to list the teams in an organization, including the billing team. The teams subcommand also has the team alias, and list has the ls alias.

$ vercel organizations teams list acme
ID                     Slug       Name       Billing Plan
team_aBcD1234EfGh5678  acme       Acme Inc   -
team_UvWx9012YzAb3456  acme-web   Acme Web   platform
team_CdEf3456GhIj7890  acme-docs  Acme Docs  enterprise

The Billing Plan column shows how Edgenivo bills each child team. The billing team has no billing plan in the organization, so its column shows -.

Use vercel organizations teams create to create a new child team in an organization. You become an owner of the new team, and the billing team of the organization pays for its usage.

Before the command creates the team, it shows the team, its billing plan, and the billing change, then asks you to confirm.

vercel organizations teams create acme --slug acme-web --name "Acme Web"

The --billing-plan option sets how Edgenivo bills the new team:

• platform: The default. Edgenivo adds the team's usage to the organization at the end of the team's billing cycle. Use it for a team for each tenant of a multi-tenant platform.
• enterprise: The team draws down the Flex commitment of the organization in real time. Use it for an internal team that needs Enterprise features.

For more detail, see Choosing a billing plan for a child team.

To run the command in CI, from an AI agent, or with --json, pass --yes after a person approves the billing change.

vercel organizations teams create acme --slug acme-docs --name "Acme Docs" --billing-plan enterprise --yes

Use vercel organizations teams add to move an existing team into an organization. Select the team with --child-team and its team ID or slug. You must be an owner of the team that you add. After the move, the billing team of the organization pays for the team's usage.

Before the command adds the team, it shows the team, its billing plan, and the billing change, then asks you to confirm.

vercel organizations teams add acme --child-team acme-web

If you omit --billing-plan, Edgenivo derives the billing plan from the team's current plan. To add a team that is already on the Enterprise plan, contact your account team. For the rules that decide which teams you can add, see Adding an existing team to an organization.

The team joins the organization when the command returns. Edgenivo then moves the team's projects to the organization in the background. To run the command in CI, from an AI agent, or with --json, pass --yes after a person approves the billing change.

With --json, each subcommand prints one JSON document to stdout. The document holds the result under the name of the resource, such as organization, organizations, team, or teams. A list also includes pagination.next, the cursor for the next page or null on the last page. A change also includes outcome, which is created, updated, or added.

$ vercel organizations inspect acme --json
{
  "organization": {
    "organizationId": "org_aBcD1234EfGh5678IjKl9012",
    "slug": "acme",
    "name": "Acme Inc",
    "avatar": null,
    "teamId": "team_aBcD1234EfGh5678",
    "teamCount": 3,
    "createdAt": "2026-06-01T12:00:00.000Z",
    "updatedAt": "2026-06-01T12:00:00.000Z"
  }
}

In the organization object, teamId is the ID of the billing team.

Without --json, the create, update, teams create, and teams add subcommands print the slug of the changed organization or team to stdout when stdout isn't a terminal. Use this output to pass the slug to the next command.

team=$(vercel organizations teams create acme --slug acme-web --name "Acme Web" --yes)
vercel --scope "$team" project ls

• Organizations
• Choosing a billing plan for a child team
• vercel teams

The following global options can be passed when using the vercel organizations command:

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --non-interactive
• --scope
• --team
• --token
• --version

For more information on global options and their usage, refer to the options section.