文档首页/ 云空间服务 KooDrive/ API参考/ API/ 部门管理/ 创建部门 - CreateDepartment
更新时间：2025-10-21 GMT+08:00
查看PDF
分享

创建部门 - CreateDepartment

功能介绍

创建一个部门，并分配团队空间。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/departments

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

X-Traceid

否

String

消息日志跟踪标识（必须58位）

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

Host

是

String

地址，用于app鉴权
表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

部门名称

parentId

是

String

父部门标识

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

data

DeptData object

消息体

code

Integer

信息码

msg

String

信息
表4 DeptData

参数

参数类型

描述

id

String

部门id

请求示例

创建一个名为test16，父部门id为1245640257345455489的部门。

POST /koodrive/ose/v1/departments

Authorization:Bearer+10f88**********4791e9ff

{
  "name": "test16",
  "parentId": "1245640257345455489"
}

响应示例

状态码：200

部门创建结果

{
  “data”：{
     id:"String 
  }
  "code": 0,
  "msg": "success"
}

状态码

状态码

描述

200

部门创建结果
父主题： 部门管理