delete_project

Delete a Bridge Town project. Requires Owner role on the project. This permanently removes the project and all its git history, files, and collaborator grants. The action cannot be undone. Safety: defaults to dry_run=True to confirm you are targeting the right project. The dry-run response lists what will be deleted without mutating anything and returns a confirmation_token.

destructive

Parameters

Name	Type	Required	Default	Description
project_name	Annotated[str, Field(description='Name of the project to delete. Requires Owner role. This action is permanent and cannot be undone.')]	Yes	—
dry_run	Annotated[bool, Field(description='When true, simulate the deletion and return what would be removed without mutating anything. Defaults to true.')]	No	True
confirmation_token	`Annotated[str	None, Field(description=‘Token required to confirm deletion (returned by a dry run).’)]`	No	None

Returns

Returns a structured object. Top-level fields:

• project (string)
• deleted (boolean)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "delete_project",
  "arguments": {
    "project_name": "forecasts"
  }
}

Response

{
  "project": "forecasts",
  "deleted": true
}

Notes

• Module: Projects
• Requires authentication via API token or Auth0 JWT.