| Time | Status | User Agent |  |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |

#### URL Expired

The URL for this request expired after 30 days.

Returns the updated Audience for convenience.

### Parameters

| Field             | Type    | Required | Description                                                                                      |
|-------------------|---------|----------|--------------------------------------------------------------------------------------------------|
| audience_id       | string  | required | The internal (or external, if `is_external_id` is true) ID of the Audience of interest.        |
| is_external_id    | string  | optional | Whether to treat the `audience_id` as an external ID.                                         |
| name              | string  | required | The name of the Audience.                                                                        |
| description       | string  | optional | A brief description of the Audience.                                                           |
| external_id       | string  | required | Must be unique among all Audiences owned by you.                                                |

# Example Request

```shell
curl https://api.usebutton.com/v1/audiences \
  -X PUT \
  -u YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "external_id": "string"
  }'
```

### Response

```json
{
  "status": 200,
  "message": "Result",
  "updated": "about 1 year ago"
}
```