> For the complete documentation index, see [llms.txt](https://relationlabs.gitbook.io/relation-one-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://relationlabs.gitbook.io/relation-one-api/api-zh/api/channel/update.md).

# 设置群公告

## <mark style="color:green;">POST</mark> api/v1/channel/announcement/update

* 说明：设置群组的公告，仅群组管理员可操作。
* Header

| Field         | Type   | Remarks                                                            |
| ------------- | ------ | ------------------------------------------------------------------ |
| ApiKey        | String | 从管理员获取的[ApiKey](/relation-one-api/api-zh/guide/glossary.md#apikey) |
| Authorization | String | Bearer ${unifiedAuthToken} ,其中unifiedAuthToken来自/api/v1/auth接口的返回  |

* Request Parameters

| Field           | Type    | Remarks                |
| --------------- | ------- | ---------------------- |
| channelUuid     | String  | 群组的uuid                |
| announcement    | String  | 公告内容                   |
| pinAnnouncement | boolean | 是否置顶，true-置顶；false-不置顶 |

* Request Example

```shell
curl POST 'https://api.relationlabs.ai/api/v1/channel/announcement/update' \
--header 'ApiKey: <ApiKey>' \
--header 'Authorization: bearer eyJhbGciOiJFUzI1NiJ9.eyJqdGkiOiI0MzdiN2EzZDEwMGY0ODVkOWVhMWUzZmZlOWE1NmEyZSIsImlzcyI6InJlbGF0aW9ubGFicy5haSIsImlhdCI6MTY2NTIxNTUzNSwic3ViIjoiZGhreXEtc3FhYWEtYWFhYWotc2d6M3EtY2FpIiwiZXhwIjoxNjY1ODIwMzM1fQ.rj7KKuIcgmvaIwZ63YHnXQ4jvvI-eR2Wo7k3YEyzMuxo8j5ezCowKDpcW0u9zIuHPFqwD0-1XPWdPLR1d1HLFw' \
--header 'Content-Type: application/json' \
--data-raw '{

    "channelUuid":"4f326124812c41448bc587bf6b2eaf42",
    "announcement":"1234",
    "pinAnnouncement":true
}'
```

* Response Parameters

| Field | Type   | Remarks |
| ----- | ------ | ------- |
| code  | String | 返回码     |
| desc  | String | 返回信息    |

* Response Body

```json
{
  "code": "0",
  "desc": "success",
  "data": null
}
```

* Return Code

| code  | desc                                    | Remarks       |
| ----- | --------------------------------------- | ------------- |
| 0     | success                                 | 接口调用成功        |
| 13106 | Not the owner of this club              | 非当前club的所属者   |
| 13107 | Not the admin of this group             | 非当前群组的管理员     |
| 13109 | The current group type is not supported | 当前操作仅支持type=G |