Skip to main content

Tags

Refer to our tag definition for more information.

Create

POST /tags.create

Sample request

{
"name": "Urgent",
"color": "tag-red" // one of tag-red | tag-blue | tag-green | tag-purple
}

If the tag is successfully created, the request returns status code 201 (created) with the tag ID in the response body.

Sample response

{
"id": "TAG-UUID",
"name": "Urgent",
"color": "tag-red"
}

Update

POST /tags.update

Sample request

{
"id": "TAG-ID",
"name": "Urgent",
"color": "tag-blue" // one of tag-red | tag-blue | tag-green | tag-purple
}

Empty response (204)

Delete

POST /tags.delete

Sample request

{
"id": "ID-OF-THE-TAG"
}

Empty response (204)

List

POST /tags.list

Sample response

{
"tags": [
{
"id": "TAG-ID",
"name": "name of the tag",
"color": "tag-red"
}
]
}