更新公告

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，更新公告。

说明

只有以下权限的人员可更新公告：

主管理员。

公告子管理员并且是待修改公告的创建者。

调用本接口，可更新公告。接口调用成功后，实现效果与下图操作实现效果一致。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	钉钉公告管理权限	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

curl --location --request POST 'https://oapi.dingtalk.com/topapi/blackboard/update?access_token=6d1bxxxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "update_request": { "ding": true, "operation_userid": "manager4220", "category_id": "89uuy7ytg6bnnjh7", "author": "杨xx", "blackboard_id": "09fa8384ac52cd0a826f1bf5b983e184", "coverpic_mediaid": "@lADPDeC2ufXOeRzMqM0BLA", "title": "入职须知", "content": "欢迎加入我们的大家庭", "notify": true } }'

请求参数

Query 参数

access_token

必需

调用服务端接口的授权凭证。企业内部应用可通过调用access_token接口获得。

示例值:

6d1bxxxx

Body 参数application/json

update_request

object

请求对象。

必需

author

string

公告作者。

可选

ding

boolean

可选

是否发送应用内钉提醒：false：不发送true：发送

blackboard_id

string

公告ID。

必需

title

string

公告标题。

必需

content

string

公告内容。

必需

category_id

string

可选

公告分类ID，可以通过获取公告分类列表接口获取有效值。

notify

boolean

可选

修改后是否再次通知接收人。

operation_userid

string

必需

操作人userid，必须是公告管理员。

coverpic_mediaid

string

可选

封面图，格式为@mediaId。可以通过上传媒体文件接口上传图片获取mediaId。

示例

application/json

Body

result

boolean

是否成功。

可选

success

boolean

本次调用是否成功。

可选

errcode

number

返回码。

可选

request_id

string

请求ID。

可选

权限#

请求参数

返回响应

权限