Skip to main content
Schedules

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

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

GET /api/v1/forward/schedule_runs/{run_id} 単一の Schedule Run 実行レコードを返します。所有権の追加制約として identity_id を指定できます。

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT または SAT>

Path parameters

ParameterTypeRequiredDescription
run_idstringYesSchedule Run ID。

Query parameters

ParameterTypeRequiredDefaultDescription
identity_idstringNo-所有権の追加制約(任意)。

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,
  "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 オブジェクトを返します。トリガーコンテキストとエラータイプも共通のデータ構造で定義されています。

Errors

HTTPTypeCodeTrigger
401authentication_errorauthentication_requiredPAT または SAT が無効または期限切れです。
404not_found_errorschedule_run_not_found実行が存在しない、テナントをまたいでいる、または identity_id 制約を満たしません。

Notes

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