Skip to main content
Schedules

获取 Schedule Run

根据 ID 获取一条 Schedule Run。

GET /api/v1/forward/schedule_runs/{run_id} 返回单条 Schedule Run 执行记录。可传 identity_id 作为额外归属约束；需要回查本次所选输入时，传 include_initial_events=true。

请求头

Header是否必填说明
Authorization是Bearer <PAT 或 SAT>

路径参数

参数类型是否必填说明
run_idstring是Schedule Run ID。

查询参数

参数类型是否必填默认值说明
identity_idstring否-额外归属约束。
include_initial_eventsboolean否false为 true 时，按需返回当前执行尝试已绑定的输入快照。

示例请求

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

示例响应

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

响应字段

返回完整 Schedule Run 对象。触发上下文和错误类型也在公共数据结构中定义。

查询输入快照

curl -s 'https://api.qoder.com.cn/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 不附带输入全文。

错误

HTTPTypeCode触发条件
400invalid_request_errorinvalid_include_initial_eventsinclude_initial_events 不是有效的 boolean 值。
404not_found_errorschedule_run_not_foundRun 不存在、跨租户，或不满足 identity_id 约束。
401authentication_error-PAT 或 SAT 无效或已过期。

备注

  • error.type=concurrency_limit_reached 表示已记录本次触发，但因并发限制被跳过。
  • 可轮询本接口直到 status 进入终态。

相关

列出 Schedule Runs

获取 Schedule