Sign in
Strategic Tickets

Rename or recolour a ticket label

Rename a label, recolour it, or both. It is one write on the list and touches no ticket, because a ticket holds the label's ID. Answers with the whole list. Requires a read_write key.

patch/v1/projects/{projectId}/tickets/labels/{labelId}

Request

  • Base URL: https://api.competlab.com
  • URL: https://api.competlab.com/v1/projects/{projectId}/tickets/labels/{labelId}
  • Auth: API key in header CL-API-Key

Path parameters

labelIdstring required
Example:3f2a9c6e-1b77-4c1e-9a54-5c7b2f0a91d2

Label ID, as the label list returns it

projectIdstring required
Example:507f1f77bcf86cd799439011

Project ID

Request body

namestring

The label's name. Unique within the project, compared without regard to case, at most 40 characters. A project holds at most 50 labels.

colorstring

The label's colour, as hex — #rrggbb. It is stored lower-case, which is the form every tracker a ticket may be copied into speaks.

Example request

{
  "name": "Pricing page",
  "color": "#3b82f6"
}

Response

Example response

{
  "items": [
    {
      "id": "3f2a9c6e-1b77-4c1e-9a54-5c7b2f0a91d2",
      "name": "Pricing page",
      "color": "#3b82f6"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.