Skip to main content
Schedules

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

1 つの Schedule Run を ID で取得します。

GET /api/v1/forward/schedule_runs/{run_id} 単一の Schedule Run 実行レコードを返します。所有権の追加制約として identity_id を指定できます。 この Run で選択された入力を確認するには、include_initial_events=true を指定します。 この API は PAT または管理者 SAT のみを許可します。Identity-bound SAT は、自身の identity_id を指定しても呼び出せません。

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT または管理者 SAT>

Path parameters

ParameterTypeRequiredDescription
run_idstringYesSchedule Run ID。

Query parameters

ParameterTypeRequiredDefaultDescription
identity_idstringNo-所有権の追加制約(任意)。
include_initial_eventsbooleanNofalsetrue の場合、現在の実行試行にバインドされた入力スナップショットを取得可能なときに返します。

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/schedule_runs/srun_019f00112233445566778899aabbccdd' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK 
{
  "id": "srun_019f00112233445566778899aabbccdd",
  "source": "tool",
  "source_session_id": "sess_origin",
  "schedule_id": "sched_019f00112233445566778899aabbccdd",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "session_id": "sess_019ec55a68b37e1e8d660691af161ab4",
  "status": "completed",
  "trigger_context": {
    "type": "schedule",
    "scheduled_at": "2026-06-22T01:00:00Z"
  },
  "result_payload": "Today's technology highlights: ...",
  "push_sink": "im_channel",
  "push_status": "succeeded",
  "push_finished_at": "2026-06-22T01:00:21Z",
  "attempt": 2,
  "initial_events_version": 1,
  "triggered_at": "2026-06-22T01:00:00Z",
  "started_at": "2026-06-22T01:00:03Z",
  "completed_at": "2026-06-22T01:00:20Z",
  "duration_ms": 17000,
  "created_at": "2026-06-22T01:00:00Z"
}

Response fields

完全な Schedule Run オブジェクトを返します。トリガーコンテキストとエラータイプも共通のデータ構造で定義されています。

入力スナップショットの取得

curl -s 'https://api.qoder.com/api/v1/forward/schedule_runs/srun_019f00112233445566778899aabbccdd?include_initial_events=true' \
  -H "Authorization: Bearer $QODER_PAT"
入力がバインド済みで確認できる場合、レスポンスに initial_events が追加されます。以下はレスポンスの抜粋です。 
{
  "attempt": 2,
  "initial_events_version": 1,
  "initial_events": [
    {
      "type": "user.message",
      "content": "Summarize today's technology highlights."
    }
  ]
}
  • initial_events は Run の現在または最終の attempt にバインドされた入力で、initial_events_version に対応します。現在の Schedule 設定ではなく、過去の各試行の入力一覧も提供しません。
  • 未バインド、過去の記録を確認できない場合、バインドが無効な場合は initial_events を省略します。null、空配列、現在の Schedule 入力で代替しません。
  • スナップショットは選択済みの入力を示すもので、ランタイムでの受信や実行成功を保証しません。
  • パラメーターの省略、false、空の値では既定のレスポンスを維持します。Run 一覧、手動実行のレスポンス、Webhook には入力全文を含めません。

Errors

HTTPTypeCode発生条件
400invalid_request_errorinvalid_include_initial_eventsinclude_initial_events が有効な boolean 値ではありません。
404not_found_errorschedule_run_not_foundRun が存在しない、現在の owner に属していない、または identity_id の制約を満たしていません。
401authentication_error-PAT または SAT が無効または期限切れです。
403permission_error-Identity-bound SAT が PAT または管理者 SAT のみを許可する API を呼び出しています。message は admin service account token required で、レスポンスに error.code は含まれません。

Notes

  • error.type=concurrency_limit_reached は、max_concurrent_runs により実行が記録されたもののスキップされたことを意味します。
  • status が終了状態に入るまで、このエンドポイントをポーリングしてください。

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

スケジュールを取得する