---
title: "Update an Audience"
method: PATCH
path: "/audiences/{audience_id}"
tags: ["Audiences"]
---

# Update an Audience

`PATCH /audiences/{audience_id}`

Update an Audience for a Project

## Path parameters

- `audience_id` integer, required

## Request body

- AudienceUpdate
  - `archived` boolean — True if the Audience has been archived
  - `conditions` string — A string defining the targeting rules for an Audience
  - `description` string — A short description of the Audience
  - `for_journey` boolean — Whether the Audience has been part of journey or not
  - `name` string — The name of the Audience
  - `segmentation` boolean — True if the Audience is available for segmentation on the results page (Enterprise plans only)

## Response `200`

Return the created Audience

- Audience
  - `archived` boolean — Whether the Audience has been archived
  - `conditions` string — A string defining the targeting rules for an Audience
  - `created` string, date-time — The time the Audience was initially created
  - `description` string — A short description of the Audience
  - `experiment_count` integer — Number of experiments by audience_id
  - `for_journey` boolean — Whether the Audience has been part of journey or not
  - `id` integer — The unique identifier for the Audience
  - `is_classic` boolean — Whether or not Audience is a classic Audience. If true, the Audience is only compatible with classic Experiments. Otherwise, the Audience may be used in Optimizely X Campaigns.
  - `last_modified` string, date-time — The last time the Audience was modified
  - `name` string — The name of the Audience
  - `project_id` integer, required — The ID of the Project the Audience was created in
  - `segmentation` boolean — True if the Audience is available for segmentation on the results page (Audiences can only be used for segmentation in Optimizely Classic). Set to False if you intend to use this Audience only in Optimizely X. Note that a maximum of 10 Audiences can have segmentation set to True in any given Optimizely Classic project.

## Other responses

- `400` — Invalid ID supplied
- `401` — Invalid credentials
- `403` — You do not have permission to edit the specified Audience
- `404` — Audience not found
- `default` — Unexpected error

---

[API](https://skmtc.net/optimizely/apis/optimizely-api.md) · [All operations](https://skmtc.net/optimizely/apis/optimizely-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimizely/optimizely-api/revisions/35d56dc0d1b9/schema)