POST /api/v1/forward/schedules/{schedule_id}/pause
Schedule を一時停止します。一時停止中のスケジュールはトリガーポリシーに基づいて実行されず、手動実行もできません。
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT> |
Content-Type | No | ボディを送信する場合は application/json。 |
Idempotency-Key | No | 安全でないリクエスト向けの任意のべき等キー。 |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
schedule_id | string | Yes | Forward Schedule ID。 |
Example request
Example response
HTTP 200 OKResponse fields
status=paused が設定された更新後の Schedule オブジェクトを返します。
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 401 | authentication_error | authentication_required | PAT が無効または期限切れです。 |
| 404 | not_found_error | schedule_not_found | Schedule が存在しません。 |
| 409 | invalid_request_error | schedule_archived | Schedule はアーカイブ済みです。 |
Notes
- ボディは省略するか、空の JSON オブジェクト
{}にできます。 - 現在の設計では手動の一時停止理由のみを公開します。