Delete a label

DELETE/api/v2/workspaces/{slug}/projects/{project_id}/labels/{pk}/

Remove a label from a project. The label disappears from every work item that carried it — the work items themselves are not touched, and nothing else about them changes.

A successful delete returns 204 with an empty body. Don't parse the response.

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 label belongs to.

pk:requiredstring (uuid)

The label id to delete.

Scopes

projects.labels:write

Errors

Status	Code	Cause
400	validation_error	A path parameter is malformed, for example a pk that isn't a UUID.
401	unauthorized	Missing or invalid credentials.
403	forbidden	Your role or token scope can't delete labels.
404	resource_not_found	No such label in this project, or the workspace or project is outside your tenant.
429	rate_limited	Throttled. Honor the Retry-After header before retrying.

Labels have no delete protection. Unlike a project's default state, no label is pinned, and a label still applied to work items deletes normally.

Deleting is not the same as unassigning

If you only want the tag off a few work items, update those work items' label_ids instead. Deleting the label strips it from every work item in the project at once, and there is no undelete endpoint — you would have to recreate the label and reapply it everywhere.

Deleting twice

A repeated delete returns 404, not 204. Treat both as "the label is gone" when your job is idempotent.

Delete a label

curl -X DELETE \
  "https://api.plane.so/api/v2/workspaces/my-team/projects/4af68566-94a4-4eb3-94aa-50dc9427067b/labels/9c1f0b3d-6d2e-4c9a-8b41-2f7e5a0d6c88/" \
  -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/labels/9c1f0b3d-6d2e-4c9a-8b41-2f7e5a0d6c88/",
    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/labels/9c1f0b3d-6d2e-4c9a-8b41-2f7e5a0d6c88/",
  {
    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": "Not Found",
  "status": 404,
  "code": "resource_not_found",
  "detail": "No label matches the given query."
}