# ノートのタグの置き換え

`PUT /api/note/{noteId}/tags`

URL: https://repsona.com/ja/api/put-note-noteid-tags

タグ名でノートのタグを置き換えます。スペースに無い名前は、指定した色で新しく作られます。

## パラメーター

| name | in | type | required | description |
| --- | --- | --- | --- | --- |
| `noteId` | path | integer | 必須 | ノートの ID |

## リクエストボディ

| name | in | type | required | description |
| --- | --- | --- | --- | --- |
| `names` | body | string[] | 必須 | ノートに付けるタグの名前 (50 件まで)。ノートのタグをこの内容に置き換え、まだ無いタグは作成します。空配列にするとタグをすべて外します。 |
| `color` | body | string \| null |  | このリクエストで新しく作るタグの色 (32 文字まで)。既存のタグの色は変わりません。省略するか `null` にすると既定の色になります。 |

## リクエスト

```sh
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"
  }'
```

## レスポンス

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

## レスポンスの例

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