メインコンテンツへスキップ
GET /api/v1/forward/schedule_runs Identity の Schedule Run を一覧表示します。schedule_id を渡すと、結果を 1 つの Schedule に絞り込めます。

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

​
Query parameters

ParameterTypeRequiredDefaultDescription
identity_idstringYes実行を所有する Forward Identity ID。
schedule_idstringNo-Schedule ID でフィルタリングします。
statusstringNo-pending、running、completed、failed、または skipped でフィルタリングします。
trigger_typestringNo-schedule または manual でフィルタリングします。
has_errorbooleanNo-エラーの有無で実行をフィルタリングします。
limitintegerNo201 ページあたりの項目数。最大 100。
after_idstringNo-指定した Run ID より後のレコードのカーソル。
before_idstringNo-指定した Run ID より前のレコードのカーソル。

​
Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/schedule_runs?identity_id=idn_019eabc123&schedule_id=sched_019f00112233445566778899aabbccdd&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "data": [
    {
      "id": "srun_019f00112233445566778899aabbccdd",
      "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"
      },
      "error": null,
      "result_payload": "Today's technology highlights: ...",
      "push_sink": "im_channel",
      "push_status": "succeeded",
      "push_finished_at": "2026-06-22T01:00:21Z",
      "attempt": 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"
    }
  ],
  "first_id": "srun_019f00112233445566778899aabbccdd",
  "last_id": "srun_019f00112233445566778899aabbccdd",
  "has_more": false
}

​
Response fields

FieldTypeDescription
dataarray現在のページの Schedule Run オブジェクト。
first_idstring|nullこのページの最初の実行の ID。
last_idstring|nullこのページの最後の実行の ID。
has_morebooleanさらにレコードが残っているかどうか。
各 data[] 項目は Schedule Run オブジェクトで、trigger_context、error、push_sink、push_status、実行タイムスタンプを含む、Get Schedule Run で説明されているものと同じフィールドを持ちます。

​
Errors

HTTPTypeCodeTrigger
400invalid_request_errorinvalid_identityidentity_id が欠落しているか無効です。
400invalid_request_errorinvalid_paginationページネーションパラメータが無効です。
401authentication_errorauthentication_requiredPAT が無効または期限切れです。

​
Notes

  • Schedule Run は独立したリソースです。
  • completed、failed、skipped は終了ステータスです。
  • push_status は IM ストリーミング配信を表し、メインの実行 status とは独立しています。

スケジュールを実行する

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