Skip to main content

スケジュールを再開する

一時停止中の Forward Schedule を再開します。

POST /api/v1/forward/schedules/{schedule_id}/unpause 一時停止中の Schedule を active ステータスに戻します。

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT または SAT>
Idempotency-KeyNo安全でないリクエスト向けの任意のべき等キー。

Path parameters

ParameterTypeRequiredDescription
schedule_idstringYesForward Schedule ID。

Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/schedules/sched_019f00112233445566778899aabbccdd/unpause' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK
{
  "id": "sched_019f00112233445566778899aabbccdd",
  "source": "api",
  "source_session_id": null,
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "name": "Daily tech brief",
  "description": "Generate a daily technology news summary",
  "status": "active",
  "resources": [],
  "initial_events_version": 1,
  "initial_events": [
    {
      "type": "user.message",
      "content": "Summarize current technology news in five bullet points."
    }
  ],
  "execution": {
    "session_mode": "new_session",
    "max_concurrent_runs": 1,
    "max_attempts": 1,
    "timeout_ms": 300000
  },
  "trigger_policy": {
    "type": "cron",
    "expression": "0 9 * * *",
    "timezone": "Asia/Shanghai",
    "upcoming_runs_at": [
      "2026-06-23T01:00:00Z"
    ]
  },
  "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
  "sinks": [],
  "metadata": {},
  "created_at": "2026-06-22T10:00:00Z",
  "updated_at": "2026-06-22T12:10:00Z"
}

Response fields

更新後の Schedule オブジェクトを返します。status=active です。

Errors

HTTPTypeCode発生条件
404not_found_errorschedule_not_foundSchedule が存在しないか、現在の owner に属していません。
409invalid_request_errorschedule_archivedSchedule はアーカイブ済みです。
409invalid_request_errorschedule_channel_unavailable配信チャネルが存在しない、アクセスできない、または配信設定が利用できません。Schedule の sinks を更新またはクリアしてから再試行してください。
409invalid_request_errorschedule_channel_disabled配信チャネルが無効です。チャネルを有効にするか、sinks を更新またはクリアしてから再試行してください。
409invalid_request_errorschedule_channel_binding_changedチャネルのバインディングが変更され、現在のタスクの要件を満たさなくなりました。sinks を更新またはクリアしてから再試行してください。
409invalid_request_errorschedule_channel_pairing_unavailableチャネルのペアリングが無効になったか、アクセスできません。再ペアリングして sinks を更新するか、sinks をクリアしてから再試行してください。
409invalid_request_errorschedule_not_activeIdentity・Template・Environment の依存先が利用不可、トリガーポリシーが不正、監視ウィンドウ内に将来のトリガー時刻がないなど、その他の再開条件を満たしていません。
401authentication_error-PAT または SAT が無効または期限切れです。
403permission_erroridentity_mismatchIdentity-bound SAT が、バインドされた Identity 以外の Schedule を要求または操作しています。

チャネルが存在しない場合のレスポンス例

HTTP 409 Conflict
{
  "type": "error",
  "request_id": "00000000-0000-4000-8000-000000000000",
  "error": {
    "type": "invalid_request_error",
    "code": "schedule_channel_unavailable",
    "message": "Cannot resume schedule because its delivery channel no longer exists or is inaccessible. Update or clear the schedule sinks, then retry."
  }
}
このエラーは、タスクが依存する配信チャネルが利用できないことを示します。Schedule の更新で有効な配信先に置き換えるか、{"sinks": []} を渡して配信設定をクリアしてから、再開 API を呼び出してください。クリア後は、そのチャネルを通じてタスクの結果は配信されません。再開操作自体がチャネルを修復または再作成することはありません。

Notes

  • 再開しても Schedule Run は直ちには作成されません。
  • 再開前に関連する依存先とトリガー設定を検証します。paused 状態は再開できますが、チャネルの無効化などの依存先の問題があると再開できません。
  • 再開に失敗した場合、タスクの状態・バージョン・次回トリガー時刻は変更されず、一時停止中のタスクは paused のままです。
  • cron / interval タスクでは、まだ有効な将来のトリガー時刻を保持します。未設定または期限切れの場合は、現在のトリガールールと監視ウィンドウに基づいて再計算し、実行されなかった過去のトリガーを補完実行しません。ウィンドウ内に将来のトリガー時刻がない場合は schedule_not_active を返します。