delete-project.md

title	Delete a project
description	Permanently delete a project and all its data via Plane API. This action is irreversible and removes all work items, cycles, and modules within the project.
keywords	plane, plane api, rest api, api integration, projects, project management

Delete a project

DELETE /api/v1/workspaces/{workspace_slug}/projects/{project_id}

Permanently deletes a project and all its associated data. This action cannot be undone.

Path Parameters

The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL https://app.plane.so/my-team/projects/, the workspace slug is my-team.

The unique identifier of the project

Scopes

projects:write

curl -X DELETE \
  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid" \
  -H "X-API-Key: $PLANE_API_KEY" \
  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \

import requests

response = requests.delete(
    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid",
    headers={"X-API-Key": "your-api-key"}
)
print(response.json())

const response = await fetch(
  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid",
  {
    method: "DELETE",
    headers: {
      "X-API-Key": "your-api-key"
    }
  }
);
const data = await response.json();

// 204 No Content