Qoder CN シリーズ:スケジュール実行

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>
Content-Type	いいえ	ボディが送信される場合は application/json です。
Idempotency-Key	いいえ	安全でないリクエストのための任意のべき等性キーです。

パスパラメーター

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

リクエストの例

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

応答の例

HTTP 200 OK

{
  "id": "srun_019f00112233445566778899aabbccdd",
  "schedule_id": "sched_019f00112233445566778899aabbccdd",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "session_id": null,
  "status": "pending",
  "trigger_context": {
    "type": "manual"
  },
  "error": null,
  "result_payload": null,
  "push_sink": null,
  "push_status": "skipped",
  "attempt": 1,
  "triggered_at": "2026-06-22T12:00:00Z",
  "started_at": null,
  "completed_at": null,
  "duration_ms": null,
  "created_at": "2026-06-22T12:00:00Z"
}

応答フィールド

作成されたスケジュール実行オブジェクトを返します。

エラー

HTTP	タイプ	コード	トリガー
401	authentication_error	authentication_required	個人用アクセストークン (PAT) が無効であるか、有効期限が切れています。
404	not_found_error	schedule_not_found	スケジュールが存在しません。
409	invalid_request_error	schedule_archived	スケジュールはアーカイブされています。
409	invalid_request_error	schedule_not_active	スケジュールは一時停止中です。

注記

• Schedule が execution.max_concurrent_runs に達した場合でも、Forward は status=skipped および error.type=concurrency_limit_reached の Run を作成します。

• status が completed、failed、または skipped になるまで Get Schedule Run をポーリングします。

関連 API

• スケジュール実行の取得

• スケジュール実行の一覧表示