Delete a comment

DELETE/api/v2/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/comments/{pk}/

Remove a comment from a work item. On success the response is 204 No Content with an empty body — there is nothing to parse, so branch on the status code.

The delete is a soft delete: the comment stops appearing in every read, including lists and its own detail route, and a follow-up GET on the same id returns 404 resource_not_found.

Deleting a comment is not reversible through the API

There is no restore endpoint, so confirm with the user before deleting. Deleting the parent work item is the usual alternative when you want the whole thread to disappear at once.

Path Parameters

slug:requiredstring

The workspace slug. It appears in your Plane URLs — in https://app.plane.so/my-team/projects/, the slug is my-team.

project_id:requiredstring (uuid)

The project the work item belongs to.

work_item_id:requiredstring (uuid)

The work item the comment is attached to.

pk:requiredstring (uuid)

The comment to delete.

Scopes

projects.work_items.comments:write

Errors

Status	Code	Cause
401	unauthorized	Missing or invalid credentials.
403	forbidden	Your role or token scope can't delete this comment.
404	resource_not_found	No such comment, it belongs to another work item, or it's already deleted.
409	conflict	The delete conflicts with the current state of the comment.
429	rate_limited	Throttled. Honor the Retry-After header before retrying.

Delete a comment

curl -X DELETE \
  "https://api.plane.so/api/v2/workspaces/my-team/projects/4af68566-94a4-4eb3-94aa-50dc9427067b/work-items/8f4c2b1e-0d3a-4f7b-9c21-6e5a8b7d4f13/comments/c1f7a3d9-2b64-4f80-9c1a-3d5e8b2a6c47/" \
  -H "X-Api-Key: $PLANE_API_KEY"

import requests

response = requests.delete(
    "https://api.plane.so/api/v2/workspaces/my-team/projects/4af68566-94a4-4eb3-94aa-50dc9427067b/work-items/8f4c2b1e-0d3a-4f7b-9c21-6e5a8b7d4f13/comments/c1f7a3d9-2b64-4f80-9c1a-3d5e8b2a6c47/",
    headers={"X-Api-Key": "your-api-key"},
)
print(response.status_code)

const response = await fetch(
  "https://api.plane.so/api/v2/workspaces/my-team/projects/4af68566-94a4-4eb3-94aa-50dc9427067b/work-items/8f4c2b1e-0d3a-4f7b-9c21-6e5a8b7d4f13/comments/c1f7a3d9-2b64-4f80-9c1a-3d5e8b2a6c47/",
  {
    method: "DELETE",
    headers: {
      "X-Api-Key": "your-api-key",
    },
  }
);
console.log(response.status);

Response204

No response body.

Response404

{
  "type": "https://api.plane.so/errors/resource_not_found",
  "title": "Resource Not Found",
  "status": 404,
  "code": "resource_not_found",
  "detail": "No comment matches the given query."
}