Skip to content

Task Labels

GET v3/labels returns all labels available in the account.
[
  {
    "id": 12254912,
    "title": "High Priority",
    "color": "#ff0000",
    "created_at": "2016-12-27T12:08:57+00:00"
  },
  {
    "id": 12254913,
    "title": "Marketing",
    "color": "#0066ff",
    "created_at": "2016-12-27T12:08:57+00:00"
  }
]
GET v3/labels/12254912 returns the specified label.
{
  "id": 12254912,
  "title": "High Priority",
  "color": "#ff0000",
  "created_at": "2016-12-27T12:08:57+00:00"
}
POST v3/labels creates a new label.
{
  "title": "Urgent",
  "color": "#ff0000"
}
201 Created is returned along with the created label.
PUT v3/labels/12254912 updates the specified label.
{
  "title": "Critical",
  "color": "#cc0000"
}
200 OK is returned along with the updated label.
DELETE v3/labels/12254912 deletes the specified label.

Removing a label does not delete tasks. It only removes the label itself.

204 No Content is returned if the label is deleted successfully. 403 Forbidden is returned if access is denied.