# 创建会议室层级

该接口用于创建会议室层级。

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/vc/v1/room_levels
HTTP Method | POST
接口频率限制 | [20 次/分钟](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新视频会议室信息(vc:room)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
name | string | 是 | 层级名称<br>**示例值**："测试层级"
parent_id | string | 是 | 父层级ID。<br>**说明**：如需在租户层级（即根层级）下创建会议室层级，可以先调用[查询会议室层级详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/get)接口，将路径参数 `room_level_id` 传入 `0` 进行查询，返回结果中的 `room_level_id` 值即为根层级 ID。<br>**示例值**："omb_4ad1a2c7a2fbc5fc9570f38456931293"
custom_group_id | string | 否 | 自定义层级ID<br>**示例值**："10000"

### 请求体示例
```json
{
    "name": "测试层级",
    "parent_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293",
    "custom_group_id": "10000"
}
```

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
room_level | room_level | 层级详情
room_level_id | string | 层级ID
name | string | 层级名称
parent_id | string | 父层级ID
path | string\[\] | 层级路径
has_child | boolean | 是否有子层级
custom_group_id | string | 自定义层级ID

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "room_level": {
            "room_level_id": "层级ID",
            "name": "测试层级",
            "parent_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293",
            "path": [
                "omb_4ad1a2c7a2fbc5fc9570f38456931293"
            ],
            "has_child": false,
            "custom_group_id": "10000"
        }
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
500 | 121001 | internal error | 服务器内部错误，如果重试无效可联系管理员
400 | 121002 | not support | 暂不支持该功能
400 | 121003 | param error | 参数错误，检查参数的取值范围（请按照上面字段说明自查）
404 | 121004 | data not exist | 请求的数据不存在
404 | 121005 | no permission | 无权限进行该操作，建议检查token类型、操作者身份以及资源的归属
404 | 121006 | data conflict | 通常由于CAS机制导致，可在更新数据后重试