fix(cli): show actionable error when removing integration with existing resources by tonypan2 · Pull Request #15164 · vercel/vercel

tonypan2 · 2026-02-19T23:13:49Z

Summary

When vc integration remove fails because the integration still has resources, the old error was a generic Failed to remove supabase: Cannot uninstall integration with resources (403)
Now catches the 403, fetches the integration's resources using integrationConfigurationId with skip-metadata=true (server-side filtering, avoids N+1 provider requests), and lists them by name
Shows actionable commands to remove the resources and retry
When running as an agent (isAgent), shows a warning to get user approval before running resource removal commands

Before

Error: Failed to remove supabase: Cannot uninstall integration with resources (403)

After

Error: Cannot uninstall supabase because it still has resources.

> Resources that must be removed first:
>   - supabase-fuchsia-window
>   - supabase-violet-chair
>   - supabase-violet-school
>   ...
>
> AGENT: You must get user approval before running any resource removal commands.
> Remove and disconnect all resources first with: vercel integration-resource remove <resource-name> --disconnect-all
> Then retry: vercel integration remove supabase

Test plan

Unit tests

$ cd packages/cli && pnpm vitest run test/unit/commands/integration/remove.test.ts

 ✓ test/unit/commands/integration/remove.test.ts  (14 tests) 241ms

 Test Files  1 passed (1)
      Tests  14 passed (14)

Manual testing

#	Test	Command	Result
1	Integration with resources	`vc integration remove supabase --yes`	43 resources listed, actionable commands shown
2	Integration not found	`vc integration remove nonexistent-xyz --yes`	`Error: No integration nonexistent-xyz found.`
3	User cancels confirmation	`vc integration remove supabase` → 'n'	`> Canceled`
4	`skip-metadata=true` verified	`vc integration remove supabase --yes --debug`	`GET /v1/storage/stores?...&skip-metadata=true`
5	Agent warning shown	`vc integration remove supabase --yes` (from agent shell)	`AGENT: You must get user approval...` shown
6	No agent warning (non-agent)	Unit test with `client.isAgent=false`	Warning absent

Code paths covered

Path	Verified by
403 + "resources" → resource list shown	Manual #1 + unit
403 + "resources" → `skip-metadata=true` in fetch	Manual #4 (--debug)
403 + "resources" → agent warning shown	Manual #5 + unit
403 + "resources" → no agent warning (non-agent)	Unit (`isAgent=false`)
403 + "resources" → stores fetch fails (catch)	Unit only
Successful removal (interactive + --yes)	Unit
User cancels confirmation	Manual #3 + unit
Integration not found	Manual #2 + unit
Non-403 error (generic)	Unit only

🤖 Generated with Claude Code

Note

Low Risk Change

CLI error handling improvement that catches a 403 error and displays more helpful error messages with resource names and actionable commands - no security, auth, or data changes.

Adds catch block for 403 error to show resource list and removal instructions
Adds agent-specific warning message when client.isAgent is true
Test and mock updates for new error handling behavior

^{Risk assessment for commit 995d440.}

changeset-bot · 2026-02-19T23:13:53Z

🦋 Changeset detected

Latest commit: 995d440

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

This PR includes changesets to release 1 package

Name	Type
vercel	Patch

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

tonypan2 · 2026-02-19T23:14:03Z

This stack of pull requests is managed by Graphite. Learn more about stacking.

github-actions · 2026-02-19T23:14: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-5pt4tx3pp.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-5pt4tx3pp.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A Python 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-5pt4tx3pp.vercel.sh/tarballs/vercel_runtime-0.6.0.dev1771880062+995d440-py3-none-any.whl"

github-actions · 2026-02-19T23:15:10Z

🧪 Unit Test Strategy

Comparing: 8244a96 → 995d440 (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

vercel · 2026-02-20T23:15:17Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
zero-config-go	Ready	Preview, Comment	Feb 20, 2026 11:15pm

packages/cli/src/commands/integration/remove-integration.ts

…ng resources

vercel bot deployed to Preview February 19, 2026 23:14 View deployment

tonypan2 force-pushed the tonypan/fix-remove-integration-resources-error branch from 9f88b30 to d5cc87c Compare February 19, 2026 23:52

vercel bot deployed to Preview February 19, 2026 23:52 View deployment

tonypan2 force-pushed the tonypan/fix-remove-integration-resources-error branch from d5cc87c to 0c5db6b Compare February 20, 2026 21:55

vercel bot deployed to Preview February 20, 2026 21:56 View deployment

tonypan2 marked this pull request as ready for review February 20, 2026 22:00

tonypan2 requested review from a team as code owners February 20, 2026 22:00

tonypan2 requested review from TheBigSadowski and bhrigu123 February 20, 2026 22:00

tonypan2 force-pushed the tonypan/fix-remove-integration-resources-error branch from 0c5db6b to 1f8bf0b Compare February 20, 2026 22:05

vercel bot deployed to Preview February 20, 2026 22:06 View deployment

tonypan2 enabled auto-merge (squash) February 20, 2026 23:12

tonypan2 force-pushed the tonypan/fix-remove-integration-resources-error branch from 1f8bf0b to 54671c5 Compare February 20, 2026 23:15

vercel bot deployed to Preview – zero-config-go February 20, 2026 23:15 View deployment

vercel bot deployed to Preview – vercel February 20, 2026 23:16 View deployment

tonypan2 removed request for TheBigSadowski and bhrigu123 February 21, 2026 17:29

mbrakken approved these changes Feb 23, 2026

View reviewed changes

packages/cli/src/commands/integration/remove-integration.ts Show resolved Hide resolved

packages/cli/src/commands/integration/remove-integration.ts Show resolved Hide resolved

tonypan2 force-pushed the tonypan/fix-remove-integration-resources-error branch from 54671c5 to 73a9fe0 Compare February 23, 2026 20:27

vercel bot deployed to Preview February 23, 2026 20:28 View deployment

fix(cli): show actionable error when removing integration with existi…

995d440

…ng resources

tonypan2 force-pushed the tonypan/fix-remove-integration-resources-error branch from 73a9fe0 to 995d440 Compare February 23, 2026 20:54

vercel bot deployed to Preview February 23, 2026 20:55 View deployment

tonypan2 merged commit fa49ec1 into main Feb 23, 2026
267 of 275 checks passed

tonypan2 deleted the tonypan/fix-remove-integration-resources-error branch February 23, 2026 21:33

vercel-release-bot mentioned this pull request Feb 23, 2026

Version Packages #15188

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(cli): show actionable error when removing integration with existing resources#15164

fix(cli): show actionable error when removing integration with existing resources#15164
tonypan2 merged 1 commit intomainfrom
tonypan/fix-remove-integration-resources-error

tonypan2 commented Feb 19, 2026 •

edited by vercel bot

Loading

Uh oh!

changeset-bot bot commented Feb 19, 2026 •

edited

Loading

Uh oh!

tonypan2 commented Feb 19, 2026

Uh oh!

github-actions bot commented Feb 19, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 19, 2026 •

edited

Loading

Uh oh!

vercel bot commented Feb 20, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

tonypan2 commented Feb 19, 2026 • edited by vercel bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Before

After

Test plan

Unit tests

Manual testing

Code paths covered

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

tonypan2 commented Feb 19, 2026

Uh oh!

github-actions bot commented Feb 19, 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

Uh oh!

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

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

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

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

tonypan2 commented Feb 19, 2026 •

edited by vercel bot

Loading

changeset-bot bot commented Feb 19, 2026 •

edited

Loading

github-actions bot commented Feb 19, 2026 •

edited

Loading

github-actions bot commented Feb 19, 2026 •

edited

Loading

vercel bot commented Feb 20, 2026 •

edited

Loading