Convex Delete Deployments

Use this skill to list and bulk-delete Convex deployments via the Convex management API.

Workflow

• Run dry-run first.

• Review candidates.

• Re-run with --apply after confirmation.

Command

python3 .agents/skills/convex-delete-deployments/scripts/delete_deployments.py
--team <team-slug>
--project <project-slug>

Default behavior is safe:

• Dry-run only unless --apply is passed.

• Targets only preview deployments unless --type is provided.

• Never deletes dev or prod unless explicitly allowed.

Common Usage

Delete all preview deployments (recommended flow):

python3 .agents/skills/convex-delete-deployments/scripts/delete_deployments.py
--team <team-slug>
--project <project-slug>

python3 .agents/skills/convex-delete-deployments/scripts/delete_deployments.py
--team <team-slug>
--project <project-slug>
--apply

Delete only specific names:

python3 .agents/skills/convex-delete-deployments/scripts/delete_deployments.py
--team <team-slug>
--project <project-slug>
--name foo-preview-1
--name foo-preview-2
--apply --yes

Regex filter and exclusions:

python3 .agents/skills/convex-delete-deployments/scripts/delete_deployments.py
--team <team-slug>
--project <project-slug>
--match '^feature-'
--exclude feature-keep-me

Safety Rules

• Keep --type preview as default for routine cleanup.

• Use --include-dev only when intentionally rotating dev deployments.

• Use --include-prod only for explicit teardown workflows.

• Always inspect dry-run output before --apply --yes .

Inputs

Token resolution order:

• --token

• CONVEX_ACCESS_TOKEN

• ~/.convex/config.json (accessToken )

Team/project resolution order:

• --team / --project

• CONVEX_TEAM / CONVEX_PROJECT