Skip to main content

删除计划任务

千问办公企业旗舰版开发者文档:删除计划任务。

认证方式见APP开发者文档 → 认证接入。
  • 模块:计划任务
  • 接口:DELETE/api/openapi/app/v1/scheduler/tasks/{task_id}
  • operationId:delete-single-scheduled-task

接口说明

软删除当前用户拥有的计划,停止后续触发;不取消已开始的Session交接或执行,不删除普通会话历史。已有执行流水仍可由原Owner查询。成功响应没有JSON正文。 接口只消费可信入口的当前用户;需启用Session计划组件且依赖就绪。支持单次与周期计划。

请求头

参数/字段位置类型必填说明
Content-TypeheaderstringJSON body时application/json

请求参数

参数/字段位置类型必填说明
task_idpathstring (uuid)是所属用户的非零任务UUID

成功响应

HTTP 204

无响应体。

拒绝与排查

HTTP错误语义
401缺少或无效的可信IAM用户入口身份;不能通过切换身份参数重试
404任务不存在或非当前用户;除执行流水外,软删除任务也不可读取
422无效任务ID、分页、请求体、触发规则或目标参数
503Session计划组件未启用或所需服务不可用
当前恢复已消费单次任务的拒绝是400 OPERATION_NOT_ALLOWED;不要把它当作任务成功恢复。错误体沿用Session现有运行时中间件,不套用管理后台错误码或生成器默认problem+json字段。保存trace_id排查,移除用户凭据。