乾策立方 开放平台文档

乾策立方 开放平台面向企业三方系统提供标准 HTTP API，支持员工、绑定关系、项目、目标与目标复盘、任务、通知、便签、标签、贡献点和附件上传能力。 所有接口默认只作用于当前 API Key 所属企业，权限由后端统一控制并在请求时强校验。

显示全部接口

任务操作接口

以下接口对应任务接收、执行、审核、审批、转发、挂起和历史任务处理等操作。所有接口都必须携带 X-Employee-Virtual-Id，接口中的员工标识统一使用当前 API Key 下的 virtualId。

权限与处理方式：查询类接口使用 tasks.read，操作类接口使用 tasks.write。除查询接口外，任务操作均通过后台队列异步处理，返回 statusCode=100 只表示操作已受理，不表示任务状态已经完成变更；请通过任务详情或 Webhook 事件确认最终状态。

任务操作初始化接口

执行需要填写原因、附件、检查项或业务选项的任务操作前，建议先调用对应的 Init 接口获取当前任务状态下可用的参数和提示信息。Init 接口使用 tasks.read 权限，返回的员工标识统一为 virtualId 或以 VirtualId 结尾的字段，不暴露内部员工 Guid。

方法路径说明常用查询参数
GET/api/openplatform/tasks/{id}/actions/decompose/metadata分解任务初始化。checkItemId 可选。
GET/api/openplatform/tasks/{id}/actions/receive/metadata接收任务初始化。无。
GET/api/openplatform/tasks/{id}/actions/refuse/metadata拒绝接收任务初始化。isEdit 可选。
GET/api/openplatform/tasks/{id}/actions/pause/metadata暂停任务初始化。无。
GET/api/openplatform/tasks/{id}/actions/auditNoPass/metadata审核不通过任务初始化。无。
GET/api/openplatform/tasks/{id}/actions/confirmReject/metadata确认审核驳回初始化。无。
GET/api/openplatform/tasks/{id}/actions/appeal/metadata申诉任务初始化。isEdit 可选。
GET/api/openplatform/tasks/{id}/actions/complete/metadata完成任务初始化。无。
GET/api/openplatform/tasks/{id}/actions/approveNoPass/metadata审批不通过任务初始化。isEdit 可选。
GET/api/openplatform/tasks/{id}/actions/cancelApply/metadata申请撤销任务初始化。isEdit 可选。
GET/api/openplatform/tasks/{id}/actions/activate/metadata历史任务变为执行中初始化。isEdit 可选。
GET/api/openplatform/tasks/{id}/actions/forceActivate/metadata历史任务强制激活初始化。无。
GET/api/openplatform/tasks/{id}/actions/applyStart/metadata挂起任务申请启动初始化。isEdit 可选。
GET/api/openplatform/tasks/{id}/actions/applySuspend/metadata进行中任务申请挂起初始化。isEdit 可选。
GET/api/openplatform/tasks/{id}/actions/executorEdit/metadata负责人修改任务初始化。actionType 为修改类型，isEdit 可选。
GET/api/openplatform/tasks/creationMetadata创建任务初始化。actionType、projectId 可选。
GET/api/openplatform/tasks/actions/judge/metadata任务评定（审核）初始化，返回当前企业评定等级集合（JudgeRate，含各档名称与系数）与 EnableEditJudgeScore；审核前必调，用于按档位折算评定贡献点。taskId 可选。
调用约定：isEdit=true 表示读取当前操作人上一次提交的原因和附件，用于编辑已有申请；checkItemId、taskId、projectId 使用任务或项目的公开标识。Init 成功只表示初始化数据读取成功，随后仍需按对应操作接口的请求体提交动作。

查询与记录

方法路径说明
GET/api/openplatform/tasks/{id}/operationRecords获取任务操作记录。查询参数：recordType 默认 0、page 默认 1、pageSize 默认 20，最大 100。
GET/api/openplatform/tasks/{id}/checkerOperationRecords获取任务检查人、结果审核人的操作记录，返回分页数据。
GET/api/openplatform/tasks/{id}/proceeds获取任务已提交的进展条目（含进展 id 与纯文本正文），用于回看进展和取可修改条目的标识。查询参数：page 默认 1、pageSize 默认 20，最大 100。
GET/api/openplatform/tasks任务列表统一入口：待我操作、我负责的、我参与的、历史任务通过 view 范围参数传入（pendingActions 待我操作 / ownedByMe 我负责的 / involvedByMe 我参与的 / history 历史任务），不传为全部可见。原 /tasks/owned、/tasks/involved、/tasks/pending 三个专用端点已下线，请迁移到统一入口。
列表请求参数：任务列表统一使用 GET /api/openplatform/tasks，除 page、pageSize 外支持 keyword、view（范围：待我操作/我负责的/我参与的/历史任务）、statuses（业务状态集合，含 completed 已完成、forwarding 转发中）、labelIds（多标签组合方式用 labelMatchMode：any 任一命中并集、all 全部命中交集，默认交集）、creatorVirtualId、assigneeVirtualId、priority、dueAtFrom、dueAtTo、receivedAtFrom、receivedAtTo、healthDegree、taskType、projectStatus 等筛选字段，除 view=history 外均可自由组合叠加；状态筛选只通过 statuses 业务分组表达，无单值精确状态参数。返回结构统一为 {"statusCode":100,"msg":"获取成功","data":{"total":0,"page":1,"pageSize":20,"items":[]}}；items 单项使用任务接口“TaskListItem 字段”表定义的字段和类型。

任务执行、审核与审批

方法路径说明
POST/api/openplatform/tasks/{id}/attachments给任务添加附件。
POST/api/openplatform/tasks/{id}/actions/submitProgress提交一条任务进展。请求体 content 必填（纯文本，最长 1000 字），可选 takeTime（小时，非负，缺省 0）、confidenceValue（1-5，缺省 3）、attachmentUrls。与添加附件一样是同步接口，返回 statusCode=100 即进展已入库，无需再查队列结果。
POST/api/openplatform/tasks/{id}/actions/updateProgress修改某条当天进展。请求体 proceedId 与 content 必填，takeTime/confidenceValue 不传保留原值，attachmentUrls 不传保留原有附件、传空数组表示清空附件。只能修改当天且由当前操作人本人提交的进展，跨天或非本人会被拒绝。同步接口。
POST/api/openplatform/tasks/{id}/actions/decompose分解任务，创建子任务；请求体中的负责人和审核人使用 assigneeVirtualId、checkerVirtualId。
POST/api/openplatform/tasks/{id}/actions/receive负责人接收任务。
POST/api/openplatform/tasks/{id}/actions/start启动任务。
POST/api/openplatform/tasks/{id}/actions/pause暂停任务。
POST/api/openplatform/tasks/{id}/actions/refuse拒绝接收任务。
POST/api/openplatform/tasks/{id}/actions/auditPass发起人或其他需要确认任务完成的角色审核通过。请求体 reason 评语必填（部分评定档位强制评语）、score 为评定贡献点=任务贡献点×选定档位系数（先调 judge/metadata 获取档位；未指定档位时按提交分值反推匹配，任务分值为 0 按中间档；不传按评定贡献点 0 提交）。
POST/api/openplatform/tasks/{id}/actions/auditNoPass发起人或其他需要确认任务完成的角色审核不通过任务。
POST/api/openplatform/tasks/{id}/actions/confirmReject负责人确认审核驳回结果。
POST/api/openplatform/tasks/{id}/actions/appeal负责人对审核不通过发起申诉。
POST/api/openplatform/tasks/{id}/actions/rejectAppeal驳回任务申诉。
POST/api/openplatform/tasks/{id}/actions/complete负责人完成任务并提交结果。
POST/api/openplatform/tasks/{id}/actions/approveNoPass审批不通过任务。
POST/api/openplatform/tasks/{id}/actions/approvePass审批通过任务。
POST/api/openplatform/tasks/{id}/actions/sendDraft发送草稿任务。
POST/api/openplatform/tasks/{id}/actions/resend重发任务，可传新的截止时间、原因和附件。
POST/api/openplatform/tasks/{id}/actions/confirmChange确认变更任务。
POST/api/openplatform/tasks/{id}/actions/changeCheckItem批量变更检查项，使用 checkItemIds 数组（1-50 项）批量勾选/取消。
POST/api/openplatform/tasks/{id}/actions/checkItemToNote将检查项转为便签。
进展正文是纯文本：进展正文与任务正文（content，富文本）是两个不同契约。工作台与企业端的进展提交框都是普通文本输入框，展示时按原样文本渲染（只保留换行），不会渲染 HTML，也不会渲染 Markdown。因此进展正文写入 HTML 标签会被服务端拒绝（statusCode=110）、超过 1000 字被拒绝（statusCode=109），服务端不做标签清洗也不截断，需要调用方自行改为纯文本后重新提交。
{
  "statusCode": 100,
  "msg": "获取成功",
  "data": {
    "total": 1,
    "page": 1,
    "pageSize": 20,
    "items": [
      {
        "id": "8f1c2b64-3a5d-4e7f-9b0c-1d2e3f4a5b6c",
        "content": "完成初稿，待评审。",
        "takeTime": 3,
        "confidenceValue": 4,
        "currentProgress": 0.4,
        "createdAt": "2026-10-10T17:04:06",
        "isEdit": false,
        "isToday": true,
        "isCreator": true,
        "sourceFrom": 1,
        "sourceAppText": "来源于成员「张三」的个人MCP「笔记本」",
        "creator": { "virtualId": "emp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "name": "张三", "phone": "138****0000" }
      }
    ]
  }
}

进展条目字段说明

字段类型说明
idguid进展条目标识，actions/updateProgress 的 proceedId 取此值。
contentstring进展正文，入库原文（纯文本）。
takeTimedecimal该条进展登记的消耗时长（小时）。
confidenceValueint该条进展的完成信心值（1-5）。
currentProgressdecimal提交该条进展时的任务进度快照，取值 0~1 原始比例。
createdAtstring进展提交时间，ISO 8601。
updatedAt / isEditstring / bool该条进展是否被修改过及修改时间；未被修改过时 updatedAt 为 null。修改后会重置该条进展的已读名单。
isTodaybool是否当天提交。只有当天的进展可修改。
isCreatorbool是否为当前操作人本人提交。开放平台的修改通道仅允许改本人条目。
sourceFromint进展提交来源，与执行记录同口径：0 工作台（含 PC、企业端与移动端）、1 开放平台代提交。
sourceAppTextstring来源应用展示文案（如「来源于成员「张三」的个人MCP「笔记本」」）；仅 sourceFrom=1 时返回，工作台提交不返回该字段。
creatorobject进展创建人（提交人）的角色名成员对象，字段为 virtualId、name 与掩码 phone。

转发与转发审批

方法路径说明
POST/api/openplatform/tasks/{id}/actions/forward转发任务，请求体使用 assigneeVirtualId 指定新的负责人。
POST/api/openplatform/tasks/{id}/actions/forwardApprove转发审批通过。
POST/api/openplatform/tasks/{id}/actions/forwardReject转发审批不通过。
POST/api/openplatform/tasks/{id}/actions/forwardCancel转发人撤回转发。
POST/api/openplatform/tasks/{id}/actions/forwardReceive接收转发任务。
POST/api/openplatform/tasks/{id}/actions/forwardRefuse拒绝接收转发任务。

撤销、激活与关注

方法路径说明
POST/api/openplatform/tasks/{id}/actions/cancelApply进行中任务申请撤销。
POST/api/openplatform/tasks/{id}/actions/passCancelApply通过取消任务申请。
POST/api/openplatform/tasks/{id}/actions/rejectCancelApply不通过取消任务申请。
POST/api/openplatform/tasks/{id}/actions/forceCancel强制撤销任务。
POST/api/openplatform/tasks/{id}/actions/directDelete直接删除任务（仅任务发起人可执行，仅活动任务；已结束的历史任务不支持删除）。该操作不可逆，请谨慎调用。
POST/api/openplatform/tasks/{id}/actions/cancelToNote撤回任务并转存为便签，对应工作台撤回弹窗里的「存放便签」按钮（仅任务发起人可执行）。任务内容先转存为便签、原任务按删除状态撤下；一天后由后台作业物理删除任务行、检查项、操作记录与进展，只在日志库留下快照，转存出的便签不受影响。与 directDelete 的差别是这里会留一份可继续使用的便签，与 cancelApply 的差别是不需要对方同意、也不是立刻物理删除。
POST/api/openplatform/tasks/{id}/actions/activate历史任务变为执行中。
POST/api/openplatform/tasks/{id}/actions/confirmActivate负责人确认历史任务变为执行中。
POST/api/openplatform/tasks/{id}/actions/activateAppeal历史任务变为执行中申诉。
POST/api/openplatform/tasks/{id}/actions/confirmActivateAppeal确认历史任务变为执行中的申诉。
POST/api/openplatform/tasks/{id}/actions/forceActivate历史任务强制激活，请求体传 dueAt、reason 和可选 attachmentUrls；本动作与 activate 都不接收 score，激活不会改动任务贡献点，改分值只能走 PATCH /tasks/{id}（需求方 2026-10-13 裁决：修改贡献点只有编辑任务一个入口）。
POST/api/openplatform/tasks/{id}/actions/cancelActivate历史任务变为执行中取消，即取消激活并重新处理。
POST/api/openplatform/tasks/{id}/actions/follow关注或取消关注任务，由业务状态决定本次操作结果。
POST/api/openplatform/tasks/{id}/actions/approveToInProgress待审核任务变为进行中。
POST/api/openplatform/tasks/{id}/actions/responsibleCancelToInProgress负责人申请撤销任务变为进行中。
POST/api/openplatform/tasks/{id}/actions/creatorCancelToInProgress发起人、审核人或负责人申请撤销任务变为进行中。

挂起与启动申请

方法路径说明
POST/api/openplatform/tasks/{id}/actions/applyStart挂起任务申请启动。
POST/api/openplatform/tasks/{id}/actions/withdrawStart撤回申请启动。
POST/api/openplatform/tasks/{id}/actions/approveStart同意启动申请。
POST/api/openplatform/tasks/{id}/actions/rejectStart申请启动不通过。
POST/api/openplatform/tasks/{id}/actions/applySuspend进行中任务申请挂起。
POST/api/openplatform/tasks/{id}/actions/cancelSuspend取消挂起任务申请。
POST/api/openplatform/tasks/{id}/actions/approveSuspend同意挂起任务申请。
POST/api/openplatform/tasks/{id}/actions/rejectSuspend不同意挂起申请。
POST/api/openplatform/tasks/{id}/actions/resume挂起状态恢复执行。

负责人修改与催办

方法路径说明
POST/api/openplatform/tasks/{id}/actions/executorEdit负责人修改任务。
POST/api/openplatform/tasks/{id}/actions/executorCancelEdit负责人取消修改任务。
POST/api/openplatform/tasks/{id}/actions/executorEditReject负责人修改任务审批不通过。
POST/api/openplatform/tasks/{id}/actions/executorEditApprove负责人修改任务审批通过。
POST/api/openplatform/tasks/{id}/actions/urge催办任务，可通过 requiresReceipt 指定是否需要催办回执。
GET/api/openplatform/tasks/{id}/urgeReceipt获取催办回执状态。

REST 动作与 MCP 动作名对照

口径说明：REST 的动作由路径段区分（如 /actions/auditPass），MCP 的 task_execute_action 由 action 参数传内网动作名（PascalCase），二者提交到同一内网动作，对照见下表。metadata_describe_action 的 action 使用本页 Init 表中的小写初始化名，与动作名是两个维度。暂停（Pause）后的恢复用 Start；挂起（Hang）后的恢复用 RecoveryExecute，二者不可混用。进展操作是例外：MCP 侧为独立工具 task_submit_progress 与 task_update_progress，不在 task_execute_action 的动作清单内，不能用 task_execute_action 提交或修改进展。
REST 路径段MCP actionREST 路径段MCP action
decomposeDecomposereceiveReceive
startStartpausePause
refuseRefuseauditPassAuditComplete
auditNoPassOverruleconfirmRejectConfirmOverrule
appealComplainrejectAppealRejectComplain
forwardRelayforwardApproveRelayExamPass
forwardRejectRelayExamNoPassforwardCancelCancelRelay
forwardReceiveRelayReceiveforwardRefuseRelayRefuse
resendRepeatconfirmChangeConfirm
changeCheckItemChangeCheckItemcompleteComplete
approveNoPass（审批）RebutapprovePassPass
sendDraftSendDraftcheckItemToNoteCheckItemToNote
cancelApplyCancelTaskApplypassCancelApplyPassCancelTaskApply
rejectCancelApplyNoPassCancelTaskApplyforceCancelMustCancelTask
directDeleteDeletecancelToNoteCancelTaskToNote
activateChangeToIngconfirmActivateConfirmToIng
activateAppealRebutToIngconfirmActivateAppealCreConfirmRebut
forceActivateMustToDocancelActivateCancelToIng
followStarTaskapproveToInProgressExamToIng
responsibleCancelToInProgressExeCancelApplyToIngcreatorCancelToInProgressCreCancelApplyToIng
applyStartFiringApplywithdrawStartCancelFiringApply
approveStartFiringApplyPassrejectStartFiringApplyNoPass
applySuspendHangcancelSuspendCancelHangApply
approveSuspendPassHangrejectSuspendNoPassHang
rejectSuspendNoPassHangresumeRecoveryExecute
executorEditExeSingleEditexecutorCancelEditExeCancelSingleEdit
executorEditRejectExeEditNoPassexecutorEditApproveExeEditPass
urgeUrgesubmitProgress独立工具 task_submit_progress
updateProgress独立工具 task_update_progress

工作台按钮名与 MCP action 对照

口径说明：任务详情的 operateBtns[].name 与动作回执的 nextActions[].name 是工作台按钮名（小写开头），不是 task_execute_action 的 action 取值，禁止原样回填。未列入下表者多为同词仅首字母大小写不同（如按钮 examToIng 对应动作 ExamToIng）。动作名的唯一清单是 task_execute_action 工具说明与本页上方对照表，传错时报错信息会列出全部可用动作名。edit、star、copy、share、relationTarget、relationProject、setLandmark、workingHours、auditSettings、toReward、confidenceIndicator、submitProceed 等按钮不走动作通道，请改用 task_update、task_submit_progress 等对应工具。采样时点：动作回执里的 status/statusStr/nextActions 是网关在动作落库后立即回读任务详情得到的一次即时采样，不等于最终状态。撤下/删除类动作（CancelTaskApply、MustCancelTask、CancelTaskToNote、Delete）成功时源站仍在异步入队完成物理删除，本次采样可能仍停在撤销中间态（status 16「申请撤销」）并带出 cancelTaskPass、cancelTaskNoPass，照这份清单追发 PassCancelTaskApply 会命中 104「该任务当前状态不是申请撤销」，而稍后查详情已是「任务不存在」；撤下类动作以成功回执本身为结果，需要确认时改用 task_get_detail 复查（查不到即已删除），不得依据本次采样的 nextActions 追发后续动作。
按钮名按钮文案MCP action语义与后果
cancelDelete撤回CancelTaskApply、CancelTaskToNote 或 Delete（按分支）这个按钮是三条分支，不能按按钮名直接选动作；电脑端与移动端已统一为同一分流（2026-10-15）。先看撤回初始化的 isNeedApply（按角色判定：自发自收但操作人不是企业主管、或发起人撤他人任务且负责人在职时为真）：为真时走「申请撤回」，对应 CancelTaskApply——已正式派发给负责人的进行中（1）、待开始（22）、已暂停（23）、驳回（12）需对方同意（同意 PassCancelTaskApply、不同意 NoPassCancelTaskApply），尚未正式派发的待审批（6）、待发送（10）、待接收（0）、被拒收（-1）、审批不通过（7）、转发拒收（14）、转发中（9）由源站直接生效。为假时二选一：「存放便签」对应 CancelTaskToNote（任务内容先转存为便签再撤下原任务），「直接删除」对应 Delete（不留副本）。收口分两种：CancelTaskApply 是直接生效或对方同意后立刻物理删除；CancelTaskToNote 与 Delete 先按删除状态撤下、一天后由后台作业物理删除任务行、检查项、操作记录与进展，只在日志库留 JSON 快照。三者都不存在「退回草稿继续编辑」；CancelTaskApply 允许发起人或负责人发起，CancelTaskToNote 与 Delete 只限发起人。
cancelTask撤回申请CancelTaskApply该按钮只在已正式派发且发起人≠负责人时下发，恒为申请撤回、需对方同意。只改贡献点等字段请用 task_update，不需要撤单。
cancelTaskPass通过PassCancelTaskApply同意撤销申请。
cancelTaskNoPass不通过NoPassCancelTaskApply不同意撤销申请，任务回到撤销前的状态。
mustCancel强制撤回MustCancelTask无需对方同意，同样按删除任务收口（源站强制撤销的落点也是物理删除，不转便签）。两端确认弹窗原先写「撤回至便签」，与实现不符，2026-10-15 已按实现更正为「直接删除该任务、检查项/进展/附件一并移除、仅日志留快照」；移动端的「撤回」按钮此前固定走转便签，2026-10-15 已统一为本表 cancelDelete 行的同一三分支分流。
confBack确认不通过ConfirmOverrule评定不通过后负责人确认，恢复进行中。
creCancelTaskToIng、exeCancelTaskToIng放弃撤回CreCancelApplyToIng、ExeCancelApplyToIng分别为发起人申请的撤销、负责人申请的撤销。
exeCancelEdit取消修改ExeCancelSingleEdit负责人撤销自己发起的任务修改申请。

字段级修改（task_update / PATCH）

通道说明：除上述「负责人申请修改确认」流程外，开放平台还提供直接发起的字段级修改通道：REST 用 PATCH /api/openplatform/tasks/{id}（见「任务」页），MCP 用独立工具 task_update。二者提交到同一内网 task/update 通道，经工作台既有校验与操作记录留痕（记录带来源应用标识），支持的字段一致：
字段（MCP field / REST 请求体字段）值格式说明
namestring任务名称。
contentstring任务内容，URL 编码后的富文本。
scoredecimal贡献点，单位「点」，受企业贡献点规则约束。
priorityint优先级 1-5。
dueAt / dueAtstring截止时间，ISO 8601 带时区。
project / projectIdguid任务挂靠项目；空串/空字符串表示移出项目。
alignTarget / alignTargetIdguid对齐的目标；空串表示解除对齐。
keyResults / keyResultIdsguid[]关联的关键结果；空数组表示解除全部关联，需先对齐目标。
MCP task_update 示例：{ "taskId": "<任务Id>", "field": "priority", "value": "4", "reason": "批量调整" }。一次只修改一个字段；修改记录可在 task_get_operation_records 中查看，并带 sourceFrom/sourceAppText 来源标识。

共用请求体字段

字段类型适用接口说明
reasonstring拒收、审核、审批、申诉、撤销、挂起、激活等操作原因。提交前按 URL 编码规则处理，未填写时可省略或传空字符串。
attachmentUrlsstring[]添加附件、审核、审批、申诉、拒收、挂起、完成等附件访问 URL 列表，不传资源内部 Guid。
assigneeVirtualIdstring分解、转发当前 API Key 下目标负责人的员工 virtualId。
assigneeVirtualIdsstring[]分解分解任务时的负责人 virtualId 列表。
checkerVirtualIdstring分解、任务修改当前 API Key 下检查人或结果审核人的员工 virtualId。
ccVirtualIdsstring[]分解、任务修改抄送或参与员工的 virtualId 列表。
checkItemIdstring分解、负责人修改开放平台任务检查项标识，使用任务详情返回的公开值，不直接传内部模型 Guid。
checkItemIdsstring[]变更检查项检查项标识集合（1-50 项，自动去重），用于批量勾选/取消；单项语义为未完成则勾选完成、已完成则取消，与工作台一致。
contentstring分解、负责人修改、提交进展、修改进展任务内容或修改内容，富文本按 URL 编码提交。例外：提交进展与修改进展时该字段是进展正文，只接受纯文本、最长 1000 字，含 HTML 标签会被拒绝。
dueAtstring分解、重发、激活、负责人修改带时区的 ISO 8601 时间字符串。
scoredecimal分解贡献点数量，单位为“点”。修改已有任务的贡献点只能用 PATCH /tasks/{id} 的 score 字段；激活与强制激活均不接收该字段（审核动作的 score 是评定贡献点，另见 auditPass 说明）。
actionTypeint负责人修改负责人修改类型，以负责人修改初始化接口返回的类型值为准。
requiresReceiptbool催办是否需要催办回执。
valuestring负责人修改修改后的值；数组字段按 JSON 字符串提交，员工标识使用 virtualId。
isEditbool负责人修改、拒收、申诉等是否按编辑场景处理。
namestring分解、重发子任务或重发任务名称。
priorityint分解、重发任务优先级。
sendAtstring分解、重发发送时间，使用 ISO 8601 格式。
completeAttachmentbool分解、完成完成任务是否要求上传附件。
checkItemsobject[]分解、审核不通过检查项数组。每项可传 id、name、reason、attachmentUrls；审核驳回时按检查项记录不通过原因。
customItemobject[]完成按任务自定义项模型传递完成结果。
proceedIdguid修改进展要修改的进展条目标识，取 GET /api/openplatform/tasks/{id}/proceeds 返回的 items[].id；必须是当天且由当前操作人本人提交的条目。
takeTimedecimal提交进展、修改进展该条进展的消耗时长（小时），非负。提交时不传按 0；修改时不传保留原值。
confidenceValueint提交进展、修改进展该条进展的完成信心值，1-5。提交时不传按 3；修改时不传保留原值。
负责人修改截止时间：当 actionType=5 时必须传 dueAt，使用带时区的 ISO 8601 时间字符串；开放平台会将该字段提交为截止时间修改值。

操作响应

{
  "statusCode": 100,
  "msg": "操作已受理",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "action": "receive"
  }
}
回执口径：写动作成功时 data 恒为非空对象——action 即请求里提交的动作名，id 是被操作任务，与 MCP 工具同口径；源站回了载荷的动作（如分解出新任务）原样透传，不会被补出的回执覆盖。任务字段修改与撤销回 {id, "action": "update"|"cancel"}，标签全量替换回 {id, "action": "updateLabels"}。
最终状态确认：任务操作返回成功只代表网关已受理请求。请再次调用任务详情、操作记录或订阅对应的 task.* Webhook 事件确认最终状态。
© 2026 乾策立方 开放平台