创建待办
接口说明
创建待办（sourceType 仅接受 OPEN_API）；处理人不校验存在性，由调用方保证映射正确
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
winnexo:CreateTodo |
none |
*全部资源
|
无 | 无 |
请求语法
POST /openapi/createTodo HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
租户 ID，公共参数；缺省时使用调用方默认租户 |
10000 |
| title |
string |
是 |
待办标题（≤200 字） |
治理审批 |
| questions |
array<object> |
是 |
问题清单（1~N） |
example |
|
array<object> |
否 |
问题清单（1~N） |
示例问题项 |
|
| question |
string |
是 |
问题正文（引用键，清单内唯一） |
是否通过审批 |
| mode |
string |
是 |
作答形态：SINGLE_CHOICE/MULTI_CHOICE/TEXT |
SINGLE_CHOICE |
| required |
boolean |
否 |
是否必答 |
true |
| options |
array<object> |
否 |
问题的选项列表；选择题必填，每项含选项文案（label）、补充说明（description）与是否推荐（recommended） |
|
|
object |
否 |
单个选项，含选项文案、补充说明与是否推荐 |
通过 |
|
| label |
string |
是 |
选项文案（引用键） |
通过 |
| description |
string |
否 |
选项补充说明 |
选项补充说明 |
| recommended |
boolean |
否 |
是否推荐 |
false |
| allowCustom |
boolean |
否 |
是否允许自定义输入 |
false |
| customLabel |
string |
否 |
自定义输入项文案 |
其他 |
| customPlaceholder |
string |
否 |
自定义输入占位符 |
请说明 |
| customMaxLength |
integer |
否 |
自定义输入长度上限 |
200 |
| placeholder |
string |
否 |
TEXT 题占位符 |
请输入 |
| maxLength |
integer |
否 |
TEXT 题长度上限 |
500 |
| priority |
string |
否 |
优先级 |
MEDIUM |
| sourceType |
string |
是 |
待办来源（仅 OPEN_API） |
OPEN_API |
| sourceContext |
object |
是 |
来源上下文（原样透传落库，不校验） |
example |
| assigneeUserIds |
array |
是 |
处理人平台用户 ID 列表（1~100，去重后生效） |
43 |
|
string |
否 |
处理人平台用户 ID 列表（1~100，去重后生效） |
10086 |
|
| collaborationGroupId |
string |
否 |
协作空间 ID（可选） |
cg_123 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| code |
string |
业务状态码；成功为 200 |
200 |
| message |
string |
错误描述 |
请求的资源不存在 |
| requestId |
string |
请求追踪 ID |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| todoId |
string |
新建待办 ID |
todo_abc123 |
| status |
string |
待办状态 |
PENDING |
| assignees |
array<object> |
处理人列表 |
|
|
object |
处理人列表 |
示例处理人 |
|
| assigneeUserId |
string |
处理人用户 ID |
43 |
| status |
string |
处理人行状态 |
PENDING |
| gmtCreate |
string |
创建时间（ISO8601 带时区；与列表/详情的北京时间格式串不同） |
2026-10-12T15:00:00+08:00 |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "请求的资源不存在",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"todoId": "todo_abc123",
"status": "PENDING",
"assignees": [
{
"assigneeUserId": "43",
"status": "PENDING"
}
],
"gmtCreate": "2026-10-12T15:00:00+08:00"
}