Channel 会話スコープと Identity のペアリングを解除します。
DELETE /api/v1/forward/channel_pairings/{pairing_id}
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT または SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
pairing_id | string | Yes | ペアリングの一覧、ペアリングの取得、または Channel のペアリングで返される id。 |
Example request
Example response
HTTP 200 OK
Response fields
| Field | Type | Description |
|---|---|---|
id | string | Pairing ID。 |
deleted | boolean | ペアリング解除に成功した場合 true。 |
HTTP エラーコード
| HTTP | Type | 発生条件 |
|---|---|---|
| 400 | invalid_request_error | pairing_id が空白または制御文字を含む場合、またはペアリングの所属先を確認した際に Channel が pairing モードではない場合。 |
| 401 | authentication_error | PAT または SAT が無効または期限切れの場合。 |
| 403 | permission_error | API の呼び出し権限がない場合。 |
| 404 | not_found_error | ペアリングの所属先を確認した際に、所属する Channel が存在しない、アーカイブ済み、またはアクセス不可の場合。 |
| 409 | conflict_error | バインディングが同時に変更された場合。 |
Notes
- 存在しない、または解除済みのペアリングには
200とdeleted=trueを返します。存在するペアリングではアクセス権限の検証が必要です。 - 解除すると元のバインディングは無効になります。チャネルのペアリングフローを再度開始すると、新しいペアリングコードを取得できます。