Replace note tags by names

Notes View as Markdown

PUT/api/note/{noteId}/tags

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

Parameters

noteIdintegerpathRequired: ID of the note.

Request body

namesstring[]Required: Names of the tags to set (up to 50). Replaces all tags on the note; tags that do not exist yet are created. An empty array removes every tag.
colorstring | null: Color for tags created by this request (up to 32 characters). Existing tags keep their color. Omit or null for the default color.

Responses

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

Request

curl -X PUT "https://<space>.repsona.com/api/note/{noteId}/tags" \
  -H "Authorization: Bearer $REPSONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "names": [
      "launch",
      "checklist"
    ],
    "color": "#3b82f6"
  }'

Example response

{
  "tags": [
    {
      "id": 86,
      "name": "launch",
      "color": "#3b82f6"
    },
    {
      "id": 87,
      "name": "checklist",
      "color": "#3b82f6"
    }
  ]
}