Skip to content

project_delete

Managementcatalog

Delete 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

NameTypeRequiredDescription
team_idstring—Team ID. Required with project_id for OAuth callers; an API key is scoped by the key.
project_idstring✓Project ID. Get it from projects_list.
response_formatenum(json | markdown)jsonOutput 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