# タグの作成

`POST /api/tag`

URL: https://repsona.com/ja/api/post-tag

タグを作成し、作成したタグの ID を返します。

## リクエストボディ

| name | in | type | required | description |
| --- | --- | --- | --- | --- |
| `name` | body | string | 必須 | タグの名前です (1〜255 文字)。スペース内で重複できません。 |
| `type` | body | tag \| reaction \| null |  | タグの用途です。`tag` はタスクやノートに付けるラベル、`reaction` はコメントへのリアクションに使います。`null` は指定なしです。既定は `tag` です。 |
| `color` | body | string \| null |  | 色です (`#3b82f6` のような 16 進数のカラーコード、20 文字まで)。既定は `null` (色なし) です。 |

## リクエスト

```sh
curl -X POST "https://<space>.repsona.com/api/tag" \
  -H "Authorization: Bearer $REPSONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Design",
    "type": "tag",
    "color": "#3b82f6"
  }'
```

## レスポンス

- 200: Created tag id
- 400: Invalid request payload
- 401: Authentication is required

## レスポンスの例

```json
{
  "tagId": 75
}
```