Delete a project label

Retires a label from its project’s vocabulary; the tickets carrying it simply stop showing it. In the console this is the project’s managers, the same people who can add to it.

Required scope

The access token must carry this scope. A token missing it gets 403 Forbidden. Grant them to an API client under Settings → Company → API, and to a teammate under Employee → Permissions.

projects:admin

Path Parameters

Name	Type	Required	Description
`labelId`	string	Required	Label ID.

DELETEExample request

curl

curl -X DELETE "https://www.pxb.app/api/public/v1/project-labels/{labelId}" \
  -H "Authorization: Bearer your_access_token"

200Example response

json

{
  "message": "Label deleted successfully!",
  "content": {
    "labelId": "lbl_77"
  }
}

403Example response

json

{
  "message": "Only a manager of this project — or a projects admin — can delete this."
}

In the console

The same thing done by hand, for anyone comparing the API against the screen they already use.

Projects

/projects

Open a project.
Open Labels in the sidebar, then Delete label.