Teambition API
  1. 任务
Teambition API
  • 快速开始
    • 开发企业内部应用
    • 开发应用商店应用
    • 应用商店应用发布指南
  • 应用开发流程
    • 创建应用
    • 应用凭证和基本信息
    • 邀请开发人员
    • 测试应用
    • 发布应用
    • 查看操作日志
    • 开发应用
      • 安全域名
      • 应用入口配置
      • 应用权限
      • 组件
  • 开发指南
    • 调用频率限制
    • Postman 模版请求 API 使用说明
    • 授权凭证
    • 应用免登
  • API
    • 身份验证(免登)
      • 请求身份验证
      • 获取登录用户身份
      • 获取登录用户信息
    • 用户
      • 查询 IDMap
      • 批量查询用户应用可见性
    • 企业
      • 获取企业信息
      • 根据自定义字段分类统计自定义字段数
      • 搜索企业任务类型
    • 通讯录
      • 成员
        • 获取企业的管理员(含拥有者)
        • 获取企业拥有者
        • 获取企业成员列表
        • 添加企业成员
        • 更新企业成员
        • 启用企业成员账号
        • 停用企业成员账号
        • 删除企业成员
        • 获取企业成员数量
        • 批量获取企业成员
        • 搜索企业成员
      • 部门
        • 获取企业部门列表
        • 获取部门成员列表
        • 获取用户加入的企业部门列表
    • 任务
      • 更新自由任务标题
        PUT
      • 创建自由任务
        POST
      • 查询自由任务详情
        GET
      • 更新自由任务截止时间
        PUT
      • 更新自由任务执行者
        PUT
      • 更新自由任务参与者
        PUT
      • 更新自由任务完成态
        PUT
      • 更新自由任务备注
        PUT
      • 获取任务关联信息
        GET
      • 创建任务关联
        POST
      • 删除任务关联
        DELETE
      • 更新自由任务优先级
        PUT
      • 查询项目任务
        GET
      • 归档任务(移入回收站)
        GET
      • 评论任务
        POST
      • 更新任务标题
        PUT
      • 复制任务(仅支持工作流项目)
        PUT
      • 创建任务
        POST
      • 根据字段InstanceId更新任务自定义字段值(弃用)
        POST
      • 更新任务自定义字段值
        POST
      • 删除任务
        POST
      • 更新任务截止时间
        PUT
      • 更新任务执行者
        PUT
      • 更新任务参与者
        PUT
      • 移动任务(仅支持工作流项目)
        PUT
      • 更新任务备注
        PUT
    • 工时
      • 工时应用相关接口的准备工作检查清单
      • 获取单个实际工时详情
      • 获取单个计划工时详情
      • 获取单个任务的实际工时列表
      • 获取单个任务的计划工时列表
      • 获取单个任务的实际工时总和
      • 获取单个任务的计划工时总和
      • 获取一定时间内订阅的指定用户的实际工时聚合数
      • 获取一定时间内订阅的指定用户的计划工时聚合数
    • 项目
      • 创建项目
      • 更新项目
      • 删除项目
      • 查询项目详情
      • 添加项目成员
      • 获取项目成员
      • 删除项目成员
      • 检查用户是否为项目的成员
      • 更新项目成员的角色
    • 项目分组
    • 角色
    • 名额
    • 群聊
    • 统计
    • 历史版本(不推荐)
      • 任务
        • 创建任务
        • 更新任务
        • 查询任务
        • 删除任务
        • TQL查询任务
        • 创建任务列表
        • 查询任务列表
        • 删除任务列表
        • 创建任务分组
        • 更新任务分组
        • 查询任务分组
        • 删除任务分组
        • 查询任务类型
        • 获取任务类型
        • 判断任务类型是否存在
        • 查询工作流信息
        • 查询任务依赖关系
        • 查询任务关联关系
        • 删除任务关联
        • 创建任务关联关系
      • 查询用户信息
      • 查询用户设置
      • 使用邮箱获取用户 ID
      • 获取三方账号的信息
      • 批量查询用户信息
      • 更新 IDMap
    • 模型说明
    • 迭代
      • 获取迭代信息
      • 创建迭代
      • 更新迭代
      • 删除迭代
      • 获取迭代列表
    • 日程
      • 创建日程
      • 更新日程
      • 查询日程
      • 移除日程
    • 文件
      • 获取文件夹信息
      • 获取文件信息
    • 标签
      • 查询标签
    • TQL查询语音
      • TQL介绍
    • 企业(丢弃)
      • 添加企业成员
      • 获取企业成员列表
      • 获取企业成员数量
      • 获取企业的管理员(含拥有者)
      • 获取企业拥有者
      • 删除企业成员
      • 搜索企业成员
      • 批量获取企业成员
      • 启用企业成员账号
      • 停用企业成员账号
      • 获取企业部门列表
      • 获取企业部门成员列表
      • 获取用户加入的企业部门列表
    • 评论
      • 创建任务评论
  • Webhook
    • 企业自建应用 Webhook 信息推送的建立
    • Webhook请求合法性验证
    • 企业
      • 更新企业
      • 企业改名
      • 删除企业
      • 转交拥有者
      • 添加企业成员
      • 更新企业成员
      • 移除企业成员
      • 激活企业成员
      • 停用企业成员
    • 部门
      • 创建部门
      • 更新部门
      • 移动部门
      • 删除部门
      • 添加部门成员
      • 删除部门成员
    • 项目
      • 创建项目
      • 删除项目
      • 自定义字段更新
    • 任务
      • 创建任务
      • 更新任务
      • 删除任务
    • 日程
      • 创建日程
      • 更新日程
      • 删除日程
      • 参与人更新
      • 自定义字段更新
      • 日程提醒
    • 关联
      • 创建关联
      • 删除关联
    • 评论
      • 触发评论
    • 文件
      • 文件创建
      • 文件删除
      • 文件移动
      • 文件改名
      • 参与人更新
    • 应用
      • 企业安装应用
      • 企业卸载应用
      • 企业开启应用
      • 企业禁用应用
      • 项目开启应用
      • 项目关闭应用
      • 创建应用可见范围
      • 移除应用可见范围
  • 规范与指导
    • 设计规范
      • 图标规范
      • 宣传图规范
  1. 任务

创建任务

POST
https://open.teambition.com/api/v3/task/create
创建任务
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.teambition.com/api/v3/task/create' \
--header 'Authorization: Bearer <appAccessToken>' \
--header 'X-Tenant-Id: 50c32af35a87e6b2...' \
--header 'X-Tenant-Type: organization' \
--header 'Content-Type: application/json' \
--data-raw '{
    "projectId": "string",
    "content": "string",
    "executorId": "string",
    "involveMembers": "string",
    "stageId": "string",
    "tasklistId": "string",
    "taskflowstatusId": "string",
    "startDate": "string",
    "dueDate": "string",
    "note": "string",
    "priority": "string",
    "parentTaskId": "string",
    "visible": "string",
    "scenariofieldconfigId": "string",
    " customfields": [
        {
            "cfId": "string",
            "customfieldName": "string",
            "value": [
                {
                    "id": "string",
                    "title": "string",
                    "description": "string",
                    "thumbUrl": "string",
                    "url": "string",
                    "meta": "string"
                }
            ]
        }
    ]
}'
响应示例响应示例
{
  " result": {
    "id": "string",
    "taskId": "string",
    "content": "string",
    "note": "string",
    "projectId": [
      "string"
    ],
    "ancestorIds": "string",
    "parentTaskId": "string",
    "tfsId": "string",
    "tasklistId": "string",
    "stageId": "string",
    "tagIds": [
      "string"
    ],
    "creatorId": "string",
    "executorId": "string",
    "involveMembers": [
      "string"
    ],
    "priority": 0,
    "recurrence": [
      "string"
    ],
    "isDone": true,
    "isArchived": true,
    "visible": "string",
    "uniqueId": "string",
    "startDate": "string",
    "dueDate": "string",
    "accomplishTime": "string",
    "created": "string",
    "updated": "string",
    "sfcId": "string",
    "customfields": [
      {
        "cfId": "string",
        "type": "string",
        "value": [
          {
            "id": "string",
            "title": "string",
            "metaString": "string"
          }
        ]
      }
    ]
  },
  "code": "string",
  "errorMessage": "string"
}

请求参数

Header 参数
Authorization
string 
可选
默认值:
{{Authorization}}
X-Tenant-Id
string 
企业 ID
可选
默认值:
{{X-Tenant-Id}}
X-Tenant-Type
string 
可选
默认值:
organization
Body 参数application/json
projectId
string 
项目id
必需
content
string 
任务标题
必需
executorId
string 
执行者id
可选
involveMembers
string 
参与者用户ID列表
可选
stageId
string 
任务列id
可选
tasklistId
string 
任务组id
可选
taskflowstatusId
string 
任务状态id
可选
startDate
string 
开始日期
可选
dueDate
string 
截止日期
可选
note
string 
任务备注
可选
priority
string 
执行优先级
可选
parentTaskId
string 
父任务id
可选
visible
string 
可选
任务的可见性规则 involves | members
scenariofieldconfigId
string 
任务类型id
可选
 customfields
array [object {3}] 
自定义字段值列表
可选
cfId
string 
自定义字段值ID
可选
customfieldName
string 
自定义字段名字
可选
value
array [object {6}] 
自定义字段值列表
可选
示例

返回响应

🟢200成功
application/json
Body
 result
object 
复制后的任务数据
必需
id
string 
任务ID
必需
taskId
string 
任务ID
必需
content
string 
任务标题
必需
note
string 
任务备注
必需
projectId
array[string]
项目ID
必需
ancestorIds
string 
祖先任务ID列表
必需
parentTaskId
string 
父任务ID
必需
tfsId
string 
任务状态ID
必需
tasklistId
string 
任务分组ID
必需
stageId
string 
任务列ID
必需
tagIds
array[string]
标签ID集合
必需
creatorId
string 
创建人ID
必需
executorId
string 
执行人ID
必需
involveMembers
array[string]
参与者ID集合
必需
priority
integer 
任务优先级
必需
recurrence
array[string]
重复规则
必需
isDone
boolean 
是否任务已完成
必需
isArchived
boolean 
是否任务放入回收站
必需
visible
string 
必需
任务隐私性,'involves'表达仅参与者可见; 'members'表达项目成员可见
uniqueId
string 
任务数字ID
必需
startDate
string 
必需
任务开始时间(UTC)
dueDate
string 
必需
任务截止时间(UTC)
accomplishTime
string 
必需
任务完成时间(UTC)
created
string 
创建时间(UTC)
必需
updated
string 
更新时间(UTC)
必需
sfcId
string 
任务类型ID
必需
customfields
array [object {3}] 
自定义字段值集合
必需
code
string 
响应状态码
必需
errorMessage
string 
异常错误信息
必需

【Teambition】API开发者 微信交流群

用微信扫右侧二维码,加入【Teambition】API开发者 交流群,互助沟通

扫码加入交流群
上一页
复制任务(仅支持工作流项目)
下一页
根据字段InstanceId更新任务自定义字段值(弃用)
Built with