Replace task tags by names

Tasks View as Markdown

PUT/api/task/{taskId}/tags

Matches space tags by name (find-or-create with the given color) and replaces the task tag links.

Parameters

taskIdintegerpathRequired: ID of the task.

Request body

namesstring[]Required: Names of the tags the task should have (up to 50). This replaces all current tags; an empty array removes them all. Tags that do not exist yet are created.
colorstring | null: Color for newly created tags, such as #8CC230. Existing tags keep their color. Omit to use the default color.

Responses

200Updated tags
400Too many tags
401Authentication is required
403Not a project member
404Task not found

Request

curl -X PUT "https://<space>.repsona.com/api/task/{taskId}/tags" \
  -H "Authorization: Bearer $REPSONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "names": [
      "Design",
      "Launch"
    ],
    "color": "#8CC230"
  }'

Example response

{
  "tags": [
    {
      "id": 90,
      "name": "Design",
      "color": "#2196F3"
    },
    {
      "id": 91,
      "name": "Launch",
      "color": "#8CC230"
    }
  ]
}