Skip to content

删除序列

调用该接口删除指定序列。

使用限制

仅支持删除没有子序列的序列。如果序列内存在子序列,则不能直接删除。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/contact/v3/job_families/:job_family_id
HTTP MethodDELETE
接口频率限制10 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可contact:contact 更新通讯录 contact:job_family 创建、删除、更新租户的工作序列

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
job_family_idstring序列 ID。获取方式:
- 创建序列时可以从返回结果中获取(job_family_id)。 - 调用获取租户序列列表接口获取序列 ID。
示例值:"mga5oa8ayjlp9rb"

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码错误码描述排查建议
40042411job family has child can not delete当前序列下存在子序列,不能删除。你需要先删除子序列。
40042403job family tenant lock fail并发更新序列受限,请等待一段时间重试。
40442402job family not exist序列不存在。你需要检查并传入正确的序列 ID。

更多错误码信息,参见通用错误码

内容来源:飞书开放平台 · 自动爬取整理