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/organization-task/create
任务创建权限-tb-core:task:create
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.teambition.com/api/organization-task/create' \
--header 'Authorization: Bearer <appAccessToken>' \
--header 'X-Tenant-Id: 50c32af35a87e6b2...' \
--header 'X-Tenant-Type: organization' \
--header 'Content-Type: application/json' \
--data-raw '{
    "content": "string",
    "note": "string",
    "priority": 0,
    "involveMembers": [
        "string"
    ],
    "involveGroups": [
        "string"
    ],
    "involveTeams": [
        "string"
    ],
    "executorId": "string",
    "parentTaskId": "string",
    "dueDate": "string",
    "recurrence": [
        "string"
    ],
    "tagIds": [
        "string"
    ],
    "visible": "string",
    "isDone": "string"
}'
响应示例响应示例
{
  "result": {
    "id": "string",
    "content": "string",
    "note": "string",
    "organizationId": "string",
    "ancestorIds": [
      "string"
    ],
    "tagIds": [
      "string"
    ],
    "creatorId": "string",
    "executorId": [
      "string"
    ],
    "involveMembers": "string",
    "priority": 0,
    "recurrence": [
      "string"
    ],
    "isDone": true,
    "isArchive": true,
    "visible": "string",
    "startDate": "string",
    "dueDate": "string",
    "accomplished": "string",
    "created": "string",
    "updated": "string",
    "cusomfields": [
      {
        "customfieldId": "string",
        "type": "string",
        "value": [
          {
            "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
content
string 
任务标题
必需
note
string 
任务备注
必需
priority
number 
优先级
必需
involveMembers
array[string]
参与者用户ID集合
必需
involveGroups
array[string]
必需
involveTeams
array[string]
必需
executorId
string 
执行者用户ID
必需
parentTaskId
string 
父任务ID
必需
dueDate
string 
截止时间
必需
recurrence
array[string]
必需
tagIds
array[string]
必需
visible
string 
必需
isDone
string 
必需
示例

返回响应

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

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

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

扫码加入交流群
上一页
更新自由任务标题
下一页
查询自由任务详情
Built with