メインコンテンツへスキップ
POST /api/v1/forward/schedules/{schedule_id}/run Schedule のトリガーポリシーを変更せずに、Schedule Run を即座に作成します。このエンドポイントは、実行の完了時ではなく Run レコードの作成時に応答を返します。

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>
Content-TypeNoボディを送信する場合は application/json。
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/run' \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

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"
}

​
Response fields

作成された Schedule Run オブジェクトを返します。

​
Errors

HTTPTypeCodeTrigger
401authentication_errorauthentication_requiredPAT が無効または期限切れです。
404not_found_errorschedule_not_foundSchedule が存在しません。
409invalid_request_errorschedule_archivedSchedule はアーカイブ済みです。
409invalid_request_errorschedule_not_activeSchedule は一時停止中です。

​
Notes

  • Schedule が execution.max_concurrent_runs に達している場合でも、Forward は status=skipped および error.type=concurrency_limit_reached の Run を作成します。
  • status が completed、failed、または skipped になるまで Get Schedule Run をポーリングしてください。

スケジュール実行を取得する

スケジュール実行を一覧表示する