## Rename or clear an iMessage group

**post** `/api/v2/groups/{group_id}/name`

Changes the Apple-visible name of an existing iMessage group and waits for the
Sendblue line to verify the resulting state. Pass `null` or an empty string to
clear the name. The verified value is persisted as the group's `group_name`.

The group must already have an iMessage chat, and the Sendblue line serving it
must be online and support group name changes. Failed requests are not replayed
automatically; retrying the same desired state is safe.

### Path Parameters

- `group_id: string`

### Body Parameters

- `group_name: string`

  New group name; whitespace-only values are rejected, while null or an empty string clears it

### Returns

- `data: object { group_id, group_name }`

  - `group_id: string`

  - `group_name: string`

    Device-verified name; empty when cleared

- `status: "OK"`

  - `"OK"`

### Example

```http
curl https://api.sendblue.co/api/v2/groups/$GROUP_ID/name \
    -H 'Content-Type: application/json' \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET" \
    -d '{
          "group_name": "Project Falcon"
        }'
```

#### Response

```json
{
  "data": {
    "group_id": "sb_group_608acc54-d0d7-4b41-8092-9ff6e1e70455",
    "group_name": "Project Falcon"
  },
  "status": "OK"
}
```