热门推荐

5分钟开发酷应用如何开发酷应用什么是「含钉量」

常见索引

机器人免登OA审批

工作台开放

连接器开发

智能硬件接入

能力全景图

钉钉设计开放

选择应用类型

第三方企业应用开发

学习地图

动态与公告

应用开发平台简介（新版）

应用开发平台简介

开发应用（新版）

开发应用

服务端API

开发指南

API总览

身份验证（免登）

应用授权

获取访问凭证

钉钉统一授权套件

通讯录管理

上下游组织（原合作空间）

概述

创建上下游组织

获取上下游组织的邀请信息

更新分支组织在主干组织内的属性信息

设置分支组织在主干组织内的可见范围

批量通过伙伴组织的加入申请

获取已加入或正在申请加入上下游组织的组织和个人信息

获取企业已经加入的或申请加入中的上下游组织的信息

解除关联组织

上下级组织（原关联组织）

考勤

日程

日志

服务窗

音视频

钉工牌

OA审批

即时通信IM

待办任务

智能填表

组织大脑

智能人事

互动卡片

企业文化

专属开放

钉钉客联

行业开放

生态开放

应用市场

智能招聘

智能硬件

文档/文件

HCM 主数据

钉钉碳中和

宜搭应用开发

客户管理

Teambition 项目管理

钉钉快办

Agoal

炼丹炉（模型服务）

AI 助理

365会员

附录

客户端API

AppLink协议

事件订阅

常见问题

运营规范

历史文档

更新分支组织在主干组织内的属性信息新版SDK

更新于 2023-01-18调用本接口更新分支组织在主干组织内的属性信息，包括分支组织的别名，分支组织在主干组织内的通讯录位置等。

说明

如果更新分支组织在通讯录的位置是一级目录，调用本接口的挂载部门参数linkDeptId，需要传-1。

例如，关联组织是测试组织的分支组织，调用本接口可以更新关联组织的别名和在通讯录内的位置，如图。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	通讯录合作空间写权限	API Explorer
第三方企业应用	支持	通讯录合作空间写权限	API Explorer
第三方个人应用	暂不支持	通讯录合作空间写权限	暂不支持

请求方法

Loading...

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。
第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

说明

调用本接口，需要使用主干组织的访问凭证，不能使用所属组织的访问凭证。

Body参数

名称	类型	是否必填	描述
	Array	是	请求参数。
branchCorpId	String	是	分支组织的企业ID。企业内部应用，调用获取分支组织列表接口获取union_corpid参数值。第三方企业应用，调用获取分支组织列表接口获取union_corpid参数值。
unionRootName	String	是	分支组织在主干组织内的别名。
linkDeptId	Long	是	挂载节点部门ID，如果是根部门，需要传-1。企业内部应用，主干组织调用获取部门列表接口获取dept_id参数值。第三方企业应用，主干组织调用获取部门列表接口获取dept_id参数值。

错误码

HttpCode	错误码	错误信息	说明
400	parameter.blank	参数为空	参数为空
400	parameter.error	参数错误	参数错误
500	system.error	更新失败	更新失败

这篇文档是否有帮助？

本页内容

点击纠错