# マイルストーンの作成

`POST /api/milestone`

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

プロジェクトにマイルストーンを作成します。

## リクエストボディ

| name | in | type | required | description |
| --- | --- | --- | --- | --- |
| `projectId` | body | integer | 必須 | マイルストーンを作成するプロジェクトの ID です。 |
| `name` | body | string | 必須 | マイルストーンの名前です (1〜50 文字)。 |
| `dueDate` | body | integer \| null |  | 期日です (エポックミリ秒)。`null` (既定) なら期日なしです。 |

## リクエスト

```sh
curl -X POST "https://<space>.repsona.com/api/milestone" \
  -H "Authorization: Bearer $REPSONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": 253,
    "name": "Beta release",
    "dueDate": 1797292800000
  }'
```

## レスポンス

- 200: Created milestone
- 400: Invalid request payload
- 401: Authentication is required
- 403: Project membership is required

## レスポンスの例

```json
{
  "id": 30,
  "name": "Beta release",
  "dueDate": 1797292800000,
  "isClosed": false,
  "projectId": 253
}
```