重命名一个群组。只有群主有权操作,对他创建的群组重新命名。成功后,群组会收到新群组名称的消息。
Request
HTTP request
POST https://www.featapi.com/api/party/group/{id}/rename/
Parameters
Path parameters
Parameter name | Value | Description |
---|---|---|
id | string | 群组 ID |
Authorization
该请求需要授权以下scopes访问权限:
Scopes |
---|
party_group |
For more information, see the authentication and authorization page.
Request body
In the request body, supply a Party.Group resource with the following properties:
Property name | Value | Description | Notes |
name | string | 新的群组名称 |
Response
如果请求成功,该API返回重命名后的群组数据在响应体信息。
200 Rename a group successfully.
{
"data": {
"id": 7009,
"name": "更改了群组名称",
"creator": 7815769374283,
"creator_fullname": "WenWei Yang",
"create_time": "2020-06-10T10:26:16.405891Z",
"status": 0,
"is_valid": true,
"bundle_id": null
}
}
404 Not found
示例返回数据可参考 API Common – Resource Not Found