Delete
tc delete
Deletes a project for good: the app, its preview URLs, its database and its files. Pending access requests are cancelled, an audit record is kept, and the name becomes free once teardown finishes. Owner or org admin only.
tc delete [--project NAME] [--yes NAME] [--json]
| Flag | Description |
|---|---|
--yes NAME | Confirm without a prompt. Must equal the project name exactly. Required when stdin isn't a terminal (scripts, CI). |
Without --yes, tc asks you to type the project name.
danger
This can't be undone. If you might want the app back, archive it in the console instead.
Output
This deletes expenses for good: the app, preview URLs, its database and files. Pending access requests are cancelled.
Type the project name to confirm (expenses): expenses
Deleted expenses. The name is free again.
JSON: { …, "teardown": "done" | "running", "alreadyDeleted"?: true }.
Errors: a mismatched name (nothing is deleted); CONFIRM_MISMATCH; FORBIDDEN or READ_ONLY if you aren't the owner or an admin. Deleting an already-deleted project succeeds with alreadyDeleted.
Was this page helpful?