## Update Mailing List

**post** `/print-mail/v1/mailing_lists/{id}`

Update an existing mailing list.

### Path Parameters

- `id: string`

### Body Parameters

- `description: optional string`

  An optional string describing this resource. Will be visible in the API and the dashboard.

- `metadata: optional map[unknown]`

  See the section on Metadata.

### Returns

- `MailingListUpdate object { description, metadata }`

  Parameters for updating an existing mailing list.

  - `description: optional string`

    An optional string describing this resource. Will be visible in the API and the dashboard.

  - `metadata: optional map[unknown]`

    See the section on Metadata.

### Example

```http
curl https://api.postgrid.com/print-mail/v1/mailing_lists/$ID \
    -H 'Content-Type: application/json' \
    -H "X-API-Key: $POSTGRID_PRINT_MAIL_API_KEY" \
    -d '{}'
```

#### Response

```json
{
  "description": "Test Mailing List",
  "metadata": {
    "campaign": "launch"
  }
}
```