vercel integration-resource
The vercel integration-resource command (alias: vercel ir) manages individual resources provisioned from marketplace integrations. Use it to remove resources, disconnect them from projects, and configure auto-recharge thresholds.
It supports the following subcommands:
remove: Delete a resourcedisconnect: Disconnect a resource from a projectcreate-threshold: Set up auto-recharge for prepaid resources
This command deletes an integration resource permanently.
Alias: vercel ir rm
vercel integration-resource remove <resource-name>Delete an integration resource.
If the resource has connected projects, you must disconnect them first or use the --disconnect-all flag.
| Option | Shorthand | Description |
|---|---|---|
--disconnect-all | -a | Disconnect all projects from the resource before deletion. |
--yes | -y | Skip the confirmation prompt. |
--format | -F | Output format. Use json for machine-readable output. |
Non-interactive environments and JSON output mode require the --yes flag.
# Remove a resource
vercel integration-resource remove my-database
# Remove with the short alias
vercel ir rm my-cache
# Disconnect all projects and remove in one step
vercel ir remove my-database --disconnect-all
# Remove without confirmation
vercel ir rm my-cache --disconnect-all --yes
# Output as JSON
vercel ir rm my-cache -a -y --format=jsonThis command disconnects a resource from a project. If you don't specify a project, the command disconnects from the currently linked project.
vercel integration-resource disconnect <resource-name> [project-name]Disconnect a resource from a project.
| Argument | Required | Description |
|---|---|---|
resource-name | Yes | Name of the resource to disconnect. |
project-name | No | Project to disconnect from. Uses the linked project if omitted. |
| Option | Shorthand | Description |
|---|---|---|
--all | -a | Disconnect all projects from the resource. |
--yes | -y | Skip the confirmation prompt. |
--format | -F | Output format. Use json for machine-readable output. |
Non-interactive environments and JSON output mode require the --yes flag.
# Disconnect from the currently linked project
vercel integration-resource disconnect my-database
# Using the short alias
vercel ir disconnect my-redis-cache
# Disconnect from a specific project
vercel ir disconnect my-database my-project
# Disconnect all projects from the resource
vercel ir disconnect my-database --all
# Disconnect all without confirmation
vercel ir disconnect my-database -a -y
# Output as JSON
vercel ir disconnect my-database -a -y --format=jsonSets up an auto-recharge threshold for a prepaid resource. When the resource's balance drops below the minimum, it automatically purchases additional credit.
If the resource uses installation-level billing, the threshold applies to all resources under that installation.
vercel integration-resource create-threshold <resource-name> <minimum> <spend> <limit>Configure auto-recharge for a prepaid resource.
| Argument | Required | Description |
|---|---|---|
resource-name | Yes | Name of the resource to configure. |
minimum | Yes | Dollar amount that triggers a recharge (e.g., 50 for $50.00). Decimals supported (e.g., 5.75). |
spend | Yes | Dollar amount to purchase when the threshold is triggered (e.g., 100 for $100.00). Decimals supported. |
limit | Yes | Maximum spend per billing period in dollars (e.g., 2000 for $2,000.00). Decimals supported. |
| Option | Shorthand | Description |
|---|---|---|
--yes | -y | Skip the confirmation prompt. |
Non-interactive environments require the --yes flag.
- All amounts must be non-negative numbers.
minimummust be less than or equal tospend.minimummust be less than or equal tolimit.limitmust be greater than or equal tospend.- The
spendamount must fall within the billing plan's allowed range.
# Set up auto-recharge: top up $100 when balance drops below $50, max $2000/period
vercel ir create-threshold my-database 50 100 2000
# Skip confirmation
vercel ir create-threshold my-database 50 100 2000 --yesThe following global options can be passed when using the vercel integration-resource command:
For more information on global options and their usage, refer to the options section.
Was this helpful?