# POST /claim-link

> 未受け取りのBotdoorワークスペースのオーナーに、新しい受け取りリンクをメールで送信します。制限とエラーを解説します。

Source: https://docs.botdoor.co/ja/api/claim-link/

ワークスペースのオーナーに新しい受け取りリンクをメールで送り、古いリンクを無効にします。オーナーが最初のメールを見つけられないときに使います。MCPツール：`new_claim_link`。

```bash
curl -X POST https://botdoor.co/api/v1/claim-link -H "Authorization: Bearer $BOTDOOR_KEY"
```

ボディは不要です。レスポンス`200`：

```json
{"claimSent": true, "claimExpiresAt": "2026-10-18T04:00:00.000Z", "delivery": "We emailed a fresh claim link to m***@example.com. Earlier links no longer work."}
```

リンクの有効期限は、再発行してもサインアップから7日後のままです。再発行で期限は延長されません。

## 制限

- サインアップ時のメールとは別に、1つのワークスペースにつき1日2回まで新しいリンクを送信できます。
- 前回の送信から10分以内は送信できません。

## エラー

| ステータス | コード | 意味 |
|---|---|---|
| 401 | `unauthorized` | キーがない、または誤っている |
| 409 | `already_claimed` | オーナーがすでにパスワードを設定済み。送信するものはありません |
| 410 | `claim_invalid` | 7日間が過ぎた。ワークスペースは削除済み、または削除予定です |
| 429 | `rate_limited` | 前回から間がない、または本日の回数が多すぎる。`Retry-After`を確認してください |

## よくある質問

### 再発行した後も古いリンクは使えますか？

いいえ。使えるのは最新のリンクだけです。

### メールアドレスを変更できますか？

いいえ。リンクは常にサインアップ時に使ったアドレスに送られます。

### オーナーには何と伝えればよいですか？

受信箱と迷惑メールフォルダでBotdoorからのメールを探し、リンクを開いてパスワードを設定するよう伝えてください。
