feat(cli): add teams members command for scoped team by brookemosby · Pull Request #15783 · vercel/vercel

brookemosby · 2026-03-31T18:33:16Z

Summary

add a new vercel teams members subcommand (alias: member) to list members for the currently scoped team via the public /v2/teams/{teamId}/members endpoint
support --format json output for scripting/automation and keep table output for interactive usage
add telemetry tracking for the new subcommand and unit coverage for scope validation, table output, and JSON output

Test plan

pnpm --dir packages/cli run vitest-run test/unit/commands/teams/members.test.ts
ReadLints on changed files (no lints)
Full CLI type-check currently failing on branch pre-existing issues unrelated to this change

Made with Cursor

Add a public-endpoint-backed `vercel teams members` subcommand to list members for the currently scoped team, including JSON output for automation and telemetry tracking for usage visibility. Made-with: Cursor

changeset-bot · 2026-03-31T18:33:23Z

🦋 Changeset detected

Latest commit: 1e95d7e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-03-31T18:35:21Z

Low Risk — New CLI subcommand with read-only API call, telemetry, and unit tests.

members.ts: new teams members subcommand listing team members via /v2/teams/{teamId}/members
command.ts: added membersSubcommand definition with options and examples
members.test.ts: unit tests for scope validation, table output, and JSON output

^{Assessed at 1e95d7e.}

github-actions · 2026-03-31T18:37:43Z

🧪 Unit Test Strategy

Comparing: b43797b → 1e95d7e (view diff)

Strategy: Affected packages only

✅ Only testing packages that have been modified or depend on modified packages.

Affected packages - 1 (3%)

vercel

Unaffected packages - 39 (98%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples

Results

Unit tests: Only affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: Only affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

packages/cli/src/commands/teams/members.ts

…ts from the paginated `/v2/teams/{teamId}/members` API endpoint, silently returning incomplete member lists for teams with more than ~20 members. This commit fixes the issue reported at packages/cli/src/commands/teams/members.ts:62 ## Bug Analysis The `/v2/teams/{teamId}/members` Vercel API endpoint returns paginated results (consistent with all v2 API endpoints in the codebase). However, the `members.ts` implementation makes a bare request without any pagination query parameters (`limit`, `next`) and doesn't inspect the `pagination` field of the response. This means: 1. For teams with more than ~20 members, the command only shows the first page of results 2. There is no indication to the user that more members exist 3. The `TeamMembersResponse` interface didn't even include the `pagination` field, so the data was being discarded This is evident by comparing with the sibling `teams ls` command (`list.ts`), which: - Accepts a `--next` flag via `nextOption` in its subcommand definition - Passes `limit` and `next` query parameters to the API - Displays a "To display the next page run..." hint when `pagination?.count === 20` ## Fix The fix follows the exact same pagination pattern used by `teams ls`: 1. **`command.ts`**: Added `nextOption` to `membersSubcommand.options` array (it was already imported in the file for `listSubcommand`), and added a pagination example. 2. **`members.ts`**: - Added imports for `packageName`, `getCommandFlags`, and `cmd` (same imports used in `list.ts`) - Updated `TeamMembersResponse` interface to include the `pagination` field with `count`, `next`, and `prev` - Parses the `--next` flag from arguments - Validates that `--next` is an integer (same validation as `list.ts`) - Constructs a `URLSearchParams` with `limit=20` and optionally `next` for the API call - After rendering the table, checks if `pagination?.count === 20` and displays a "next page" hint command - For JSON output, includes `pagination` in the response so programmatic consumers can paginate Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com> Co-authored-by: brookemosby <[email protected]>

github-actions · 2026-04-01T19:40:39Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-j4gq8ddze.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-j4gq8ddze.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-j4gq8ddze.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775079912+1e95d7e-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-j4gq8ddze.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775079912+1e95d7e-py3-none-any.whl"

Snapshots expected the pre-members help layout; adding members widens the command column and includes the new subcommand in the teams help output. Made-with: Cursor

…API parity (#15786) ## Summary - add `vercel project members` (alias: `member`) to list project members using public `GET /v1/projects/{idOrName}/members` - add `vercel project access-groups` (alias: `accessgroups`) to list project access groups using public `GET /v1/access-groups?projectId=...` - support optional project argument, `--format json`, and list filtering options (`--search`, `--limit`, and `--next` for access groups) - include telemetry tracking and focused unit coverage for both new subcommands ## Test plan - [x] `pnpm --dir packages/cli run vitest-run test/unit/commands/project/members.test.ts` - [x] `pnpm --dir packages/cli run vitest-run test/unit/commands/project/access-groups.test.ts` - [x] `ReadLints` on changed files (no lints) - [ ] Full CLI type-check has pre-existing failures in this workspace unrelated to this change ## Notes - Stacked on top of #15783. --------- Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com> Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>

brookemosby added 5 commits March 24, 2026 15:39

updating node

5eac74d

updating node

c85968d

updating node

6cbeddd

updating node

ba1ef28

feat(cli): add teams members command

f720d3a

Add a public-endpoint-backed `vercel teams members` subcommand to list members for the currently scoped team, including JSON output for automation and telemetry tracking for usage visibility. Made-with: Cursor

brookemosby requested review from a team as code owners March 31, 2026 18:33

vercel bot deployed to Preview March 31, 2026 18:38 View deployment

jeffsee55 approved these changes Mar 31, 2026

View reviewed changes

brookemosby mentioned this pull request Mar 31, 2026

feat(cli): add project members and access-groups commands for public API parity #15786

Merged

4 tasks

vercel bot reviewed Mar 31, 2026

View reviewed changes

packages/cli/src/commands/teams/members.ts Show resolved Hide resolved

vercel bot deployed to Preview March 31, 2026 23:09 View deployment

Merge branch 'main' into brooke/cli-teams-members-public

d81ad54

brookemosby enabled auto-merge (squash) April 1, 2026 19:39

vercel bot deployed to Preview April 1, 2026 19:40 View deployment

Merge branch 'main' into brooke/cli-teams-members-public

1277fd4

vercel bot deployed to Preview April 1, 2026 20:30 View deployment

test(cli): update teams help snapshots for members subcommand

1e95d7e

Snapshots expected the pre-members help layout; adding members widens the command column and includes the new subcommand in the teams help output. Made-with: Cursor

vercel bot deployed to Preview April 1, 2026 21:46 View deployment

brookemosby merged commit 8336210 into main Apr 1, 2026
179 checks passed

brookemosby deleted the brooke/cli-teams-members-public branch April 1, 2026 22:15

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(cli): add teams members command for scoped team#15783

feat(cli): add teams members command for scoped team#15783
brookemosby merged 9 commits intomainfrom
brooke/cli-teams-members-public

brookemosby commented Mar 31, 2026

Uh oh!

changeset-bot bot commented Mar 31, 2026 •

edited

Loading

Uh oh!

vercel bot commented Mar 31, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 31, 2026 •

edited

Loading

Uh oh!

Uh oh!

github-actions bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

brookemosby commented Mar 31, 2026

Summary

Test plan

Uh oh!

changeset-bot bot commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

Uh oh!

github-actions bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

changeset-bot bot commented Mar 31, 2026 •

edited

Loading

vercel bot commented Mar 31, 2026 •

edited

Loading

github-actions bot commented Mar 31, 2026 •

edited

Loading

github-actions bot commented Apr 1, 2026 •

edited

Loading