---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://appmetrica.yandex.by/docs/en/mobile-api/push/put-group-id.md
  - https://appmetrica.yandex.by/docs/ru/mobile-api/push/put-group-id.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/en/llms.txt

# Updating a group

Changes the name of the existing [group](*group).

## Request format

```
PUT https://push.api.appmetrica.yandex.net/push/v1/management/group/{groupId}
```

#|
|| `groupId` | Group ID. ||
|#

## Request body

```json translate=no
{
  "group": {
    "name": "string",
    "send_rate": int
  }
}
```
#|
|| `group` | Information about groups. ||
|| `group.name`* | New name for the group. ||
|| `group.send_rate` | Dispatch speed limit for push messages (messages per second).

The default value is 5000 (maximum).

The minimum value is 100.


{% note info %}

Reducing the speed allows you to decrease your handling service load.

{% endnote %}

||
|#

## Response format {#response-format}

```json translate=no
{
  "group": {
    "id": int,
    "app_id": int,
    "name": "string",
    "send_rate": int
  }
}
```

#|
|| `group` | Information about groups. ||
|| `group.id` | Group ID. ||
|| `group.app_id` | App ID. ||
|| `group.name` | Unique name of the group. ||
|| `group.send_rate` | Dispatch speed limit for push messages (messages per second).

The default value is 5000 (maximum).

The minimum value is 100.


{% note info %}

Reducing the speed allows you to decrease your handling service load.

{% endnote %}

||
|#

## Sample request {#example}

{% list tabs %}

- cURL

   ```bash translate=no
   curl -X POST \
     'https://push.api.appmetrica.yandex.net/push/v1/management/group/XXXXXX' \
     -H 'Content-Type: application/json' \
     -H 'Authorization: OAuth <your_token>'
     -d '{"group":{"name":"new_group_name"}}'
   ```

   where `<your_token>` is an OAuth token that can be obtained using [instructions](https://appmetrica.yandex.by/docs/en/mobile-api/intro/authorization.md#get-oauth-token).

- HTTP

   ```http translate=no
   GET /push/v1/management/group/XXXXXX HTTP/1.1
   Host: push.api.appmetrica.yandex.net
   Content-Type: application/json
   Authorization: OAuth <your_token>
   
   {
     "group": {
       "name": "new_group_name"
     }
   }
   ```

   where `<your_token>` is an OAuth token that can be obtained using [instructions](https://appmetrica.yandex.by/docs/en/mobile-api/intro/authorization.md#get-oauth-token).

{% endlist %}

<!-- source: en/_includes/feedback-button-2.md -->
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.

<a href="../../troubleshooting/feedback-new">
  <span class="button">Contact support</span>
</a>

<a href="../../troubleshooting/feedback-docs">
  <span class="button">Suggest an improvement for documentation</span>
</a>
<!-- endsource: en/_includes/feedback-button-2.md -->

[*group]: A group is a container for sending push messages. It allows grouping messages sendings in the [push campaign report](https://appmetrica.yandex.by/docs/en/mobile-reports/push-campaign.md). The group can contain an arbitrary number of sendings. The push campaign report displays these groups at the first level along with push campaigns that are launched through the [web interface](https://appmetrica.yandex.by/docs/en/push/marketing.md).