员工身份(EIAM)
删除职务
接口
# 权限
身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。
| 权限代码 | 描述 |
|---|---|
| job_title_all | 职务管理接口的读写权限 |
| all | 全部接口读写权限 |
# 请求说明
DELETE https://{your_domain}/api/v2/tenant/job-titles/{title_id}
# 请求头
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| Authorization | 授权 | 是 | String | 格式：Bearer {access_token} |
| Content-Type | 内容类型 | 是 | String | 固定值：application/json; charset=utf-8 |
# 请求示例
无
根据请求的职务ID删除职位。职位有用户使用时不允许删除。
# 请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| title_id | 职务ID | 是 | String | 要删除的职务ID |
# 返回示例
成功示例：
HTTP/1.1 204 No Content
错误示例：
HTTP/1.1 400 Bad Request
{
"error_msg": "职务不存在",
"error_code": "JOB.TITLE.0001"
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 返回参数
无
# 错误码
| 状态码 | 错误码 | 错误信息 | 处理措施 |
|---|---|---|---|
| 400 | ENT.CONFIG.0031 | 任职管理功能未开启，请先开启此功能 | 请先在企业中心开启任职管理 |
| The job management function is not enabled, please enable this function first | |||
| 400 | JOB.TITLE.0001 | 职务不存在 | 请检查对应职务是否存在 |
| Job title does not exist | |||
| 400 | JOB.TITLE.0015 | 当前职务存在关联职位不能被删除 | 请先将此职务关联的职位取消关联再删除职务 |
| The current job title has an associated position and cannot be deleted | |||
| 400 | JOB.TITLE.0016 | 当前职务存在关联用户不能被删除 | 请先将此职务关联的用户取消关联再删除职务 |
| The current job title has an associated user and cannot be deleted |