Skip to main content
Schedules

恢复 Schedule

恢复一个 paused 的 Forward Schedule。

POST /api/v1/forward/schedules/{schedule_id}/unpause 将暂停的 Schedule 恢复为 active。

请求头

Header是否必填说明
Authorization是Bearer <PAT 或 SAT>
Idempotency-Key否有副作用请求可选的幂等键。

路径参数

参数类型是否必填说明
schedule_idstring是Forward Schedule ID。

示例请求

curl -s -X POST 'https://api.qoder.com/api/v1/forward/schedules/sched_019f00112233445566778899aabbccdd/unpause' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK 
{
  "id": "sched_019f00112233445566778899aabbccdd",
  "source": "api",
  "source_session_id": null,
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "name": "Daily tech brief",
  "description": "Generate a daily technology news summary",
  "status": "active",
  "resources": [],
  "initial_events_version": 1,
  "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": {},
  "created_at": "2026-06-22T10:00:00Z",
  "updated_at": "2026-06-22T12:10:00Z"
}

响应字段

返回更新后的 Schedule 对象，status=active。

错误

HTTPTypeCode触发条件
404not_found_errorschedule_not_foundSchedule 不存在或不属于当前 owner。
409invalid_request_errorschedule_archivedSchedule 已归档。
409invalid_request_errorschedule_channel_unavailable推送渠道不存在、不可访问，或推送配置不可用；更新或清空 Schedule 的 sinks 后重试。
409invalid_request_errorschedule_channel_disabled推送渠道已禁用；启用渠道，或更新、清空 sinks 后重试。
409invalid_request_errorschedule_channel_binding_changed渠道绑定已变化，不再满足当前任务要求；更新或清空 sinks 后重试。
409invalid_request_errorschedule_channel_pairing_unavailable渠道配对不再有效或不可访问；重新配对并更新 sinks，或清空 sinks 后重试。
409invalid_request_errorschedule_not_active其他恢复条件不满足，例如 Identity、Template 或 Environment 依赖不可用，触发策略不合法，或监控窗口内没有未来触发时间。
401authentication_error-PAT 或 SAT 无效或已过期。
403permission_erroridentity_mismatchIdentity-bound SAT 请求或操作其绑定 Identity 之外的 Schedule。

渠道不存在时的响应示例

HTTP 409 Conflict 
{
  "type": "error",
  "request_id": "00000000-0000-4000-8000-000000000000",
  "error": {
    "type": "invalid_request_error",
    "code": "schedule_channel_unavailable",
    "message": "Cannot resume schedule because its delivery channel no longer exists or is inaccessible. Update or clear the schedule sinks, then retry."
  }
}
该错误表示任务依赖的推送渠道不可用。可通过更新 Schedule 替换有效的推送目标，或传入 {"sinks": []} 清空推送配置，再调用恢复接口。清空后任务不再通过该渠道推送结果；恢复操作本身不会修复或重建渠道。

备注

  • 恢复不会立即创建 Schedule Run。
  • 恢复前会校验相关依赖和触发配置。paused 状态可以恢复；渠道失效等依赖问题会阻止恢复。
  • 恢复失败时，不修改任务状态、版本或下一次触发时间；暂停任务仍保持 paused。
  • 对 cron / interval 任务，仍有效的未来触发时间会保留；缺失或已过期时，按当前触发规则及监控窗口重新计算，不补跑已错过的触发。窗口内无未来触发时间时返回 schedule_not_active。

相关

暂停 Schedule

获取 Schedule