Qoder CN シリーズ:スケジュールの更新

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>
Content-Type	はい	application/json
Idempotency-Key	いいえ	安全でないリクエスト用の任意のべき等性キーです。

パスパラメーター

パラメーター	タイプ	必須	説明
schedule_id	文字列	はい	Forward スケジュールの ID です。

リクエストボディ

パラメーター	タイプ	必須	説明
name	文字列	いいえ	新しいスケジュール名です。
description	文字列	いいえ	新しいスケジュールの説明です。
template_id	文字列	いいえ	新しい Forward テンプレートの ID です。
initial_events	配列	いいえ	初期イベントのリストを置き換えます。
execution	object	いいえ	実行ポリシーをマージ更新します。
trigger_policy	object | null	いいえ	トリガーポリシーを更新します。null を指定すると、手動になります。
environment_id	文字列	いいえ	新しい実行環境です。
metadata	object	いいえ	メタデータをマージ更新します。値が null の場合、メタデータキーを削除します。

リクエストの例

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/schedules/sched_019f00112233445566778899aabbccdd' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekday tech brief",
    "trigger_policy": {
      "type": "cron",
      "expression": "0 9 * * 1-5",
      "timezone": "Asia/Shanghai"
    }
  }'

レスポンスの例

HTTP 200 OK

{
  "id": "sched_019f00112233445566778899aabbccdd",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "name": "Weekday tech brief",
  "description": "Generate a daily technology news summary",
  "status": "active",
  "paused_reason": null,
  "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 * * 1-5",
    "timezone": "Asia/Shanghai",
    "upcoming_runs_at": ["2026-06-23T01:00:00Z"]
  },
  "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
  "sinks": [],
  "metadata": {},
  "archived_at": null,
  "created_at": "2026-06-22T10:00:00Z",
  "updated_at": "2026-06-22T10:30:00Z"
}

レスポンスフィールド

更新後のスケジュールオブジェクトを返します。

エラー

HTTP	タイプ	コード	原因
400	invalid_request_error	invalid_trigger_policy	トリガーポリシーが無効です。
400	invalid_request_error	unsupported_sinks_input	リクエストボディには sinks が含まれます。
404	not_found_error	schedule_not_found	スケジュールが存在しません。
409	invalid_request_error	schedule_archived	スケジュールはアーカイブ済みです。

注記

• HTTP 更新リクエストは sinks の更新をサポートしていません。

• reuse_session は、Forward がこのスケジュール用に固定の実行セッションを管理することを意味します。呼び出し元は任意の既存の session_id を指定できません。

関連 API

• スケジュールの取得

• スケジュールの一時停止