project_delete
ManagementcatalogDelete Project
Not in the default tool list
This tool lives in the tool catalog. Discover it with scenario_tools_search (or enumerate everything with scenario_tools_list) and run it via scenario_tool_execute_delete. To list every tool directly, connect with ?toolsets=full.
Delete a Scenario project. DESTRUCTIVE and irreversible: the project and its content stop being reachable, and its models, generation records, API keys and project memory are deleted. Confirm the exact project (name and id from project_get) with the user first.
Needs project Admin or team admin rights, and is refused while anyone other than the caller holds a role on the project: member_count + api_key_count must be 0, or 1 when that one is the caller as Admin. Also refused while the project holds a GPU reservation. When refused, report which members and API keys remain and ask the user what to do; never remove members or delete keys to unblock a delete without a separate, explicit confirmation of each. Deleting a team's last project leaves it with none until a later call re-creates an empty default project.
Returns: { deleted: true, project_id, message }.
Example: "Delete the Old Tests project" -> project_id="proj_old123" after the user confirms.
Don't use when: you only want to remove assets or models — use asset_delete / model_delete.
destructiveopen-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| team_id | string | — | Team ID. Required with project_id for OAuth callers; an API key is scoped by the key. |
| project_id | string | ✓ | Project ID. Get it from projects_list. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |
Example Request
JSON
{
"team_id": "team_abc123",
"project_id": "proj_old123"
}Example Response
JSON
{
"deleted": true,
"project_id": "proj_old123",
"message": "The project Old Tests has been deleted"
}Common Use Cases
- Clean up a throwaway test project that has no other members or API keys left