delete-initiative.md

title	Delete an initiative
description	Permanently delete an initiative via Plane API. Removes the initiative and disassociates linked epics, projects, and labels. Returns 204 on success.
keywords	plane, plane api, rest api, api integration, initiatives, roadmap, planning

Delete an initiative

DELETE /api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/

Permanently deletes an initiative from a workspace. 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 for the initiative.

Scopes

initiatives:write

curl -X DELETE \
  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/{initiative_id}/" \
  -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/initiatives/{initiative_id}/",
    headers={"X-API-Key": "your-api-key"}
)
print(response.json())

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

// 204 No Content