Qoder CN シリーズ:スケジュールの一覧

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>

クエリパラメーター

パラメーター	タイプ	必須	デフォルト	説明
identity_id	string	はい		スケジュールが属する Forward アイデンティティの ID。
template_id	string	いいえ	-	結果の絞り込みに使用する Forward テンプレート ID。
status	string	いいえ	-	結果の絞り込みに使用するステータス。active (アクティブ) または paused (一時停止)。
include_archived	boolean	いいえ	false	アーカイブ済みのスケジュールを結果に含めるかどうか。
limit	integer	いいえ	20	ページあたりの項目数。最大 100。
after_id	string	いいえ	-	指定したスケジュール ID より後のレコードに対するカーソル。
before_id	string	いいえ	-	指定したスケジュール ID より前のレコードに対するカーソル。

リクエストの例

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

レスポンスの例

HTTP 200 OK

{
  "data": [
    {
      "id": "sched_019f00112233445566778899aabbccdd",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "name": "Daily tech brief",
      "description": "Generate a daily technology news summary",
      "status": "active",
      "paused_reason": null,
      "initial_events": [
        {
          "type": "user.message",
          "content": "Summarize current technology news in five bullet points."
        }
      ],
      "execution": {
        "session_mode": "new_session",
        "max_concurrent_runs": 1,
        "max_attempts": 1,
        "timeout_ms": 300000
      },
      "trigger_policy": {
        "type": "cron",
        "expression": "0 9 * * *",
        "timezone": "Asia/Shanghai",
        "upcoming_runs_at": ["2026-06-23T01:00:00Z"]
      },
      "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
      "sinks": [],
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-06-22T10:00:00Z",
      "updated_at": "2026-06-22T10:00:00Z"
    }
  ],
  "first_id": "sched_019f00112233445566778899aabbccdd",
  "last_id": "sched_019f00112233445566778899aabbccdd",
  "has_more": false
}

レスポンスフィールド

フィールド	タイプ	説明
data	array	現在のページに含まれるスケジュールオブジェクトの配列。
first_id	string|null	このページの先頭レコードの ID。
last_id	string|null	このページの末尾レコードの ID。
has_more	boolean	残りのレコードがあるかどうか。

エラー

HTTP	タイプ	コード	トリガー
400	invalid_request_error	invalid_identity	identity_id が指定されていないか、無効です。
400	invalid_request_error	invalid_pagination	ページネーションパラメーターが無効です。
401	authentication_error	authentication_required	PAT が無効であるか、期限切れです。

注記

• 結果は作成日時の降順で返されます。

• include_archived=true の場合にのみ、アーカイブ済みのレコードが返されます。

関連 API

• スケジュールの作成

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