---
title: "Patches an existing audience."
method: PATCH
path: "/audience/{audienceId}"
tags: ["Audience"]
---

# Patches an existing audience.

`PATCH /audience/{audienceId}`

## Path parameters

- `audienceId` string, required

## Request body

- UpdateAudienceEndpointInput
  - `name` string — The new name to give to this audience.
  - `description` string, nullable — The new description for the audience. Supports markdown. Set to null to remove.
  - `filters` IAudienceFilter[] — The new filters to apply to any orders created for this audience. A filter can be used to restrict the audience to a specific subset of users.
    - union
      - object
        - `_t` 'AndFilter', required
        - `filters` IAudienceFilter[], required
      - object
        - `_t` 'CountryFilter', required
        - `countries` string[], required
      - object
        - `_t` 'DemographicFilter', required
        - `identifier` string, required
        - `values` string[], required
      - object
        - `_t` 'DeviceFilter', required
        - `deviceTypes` DeviceType[], required
      - object
        - `_t` 'LanguageFilter', required
        - `languages` string[], required
      - object
        - `_t` 'NotFilter', required
        - `filter` IAudienceFilter, required — recursive
      - object
        - `_t` 'OrFilter', required
        - `filters` IAudienceFilter[], required
  - `logo` object, nullable — The new logo image for the audience. Must be an existing image asset. Set to null to remove the logo.
    - `name` string, required
    - `metadata` object, nullable
    - `identifier` string, nullable
  - `minGraduatedForDistillingBoost` integer, nullable — Minimum graduated users before disabling distilling boost. When graduated count is below this, external distilling audience ID is added to campaign boosting.
  - `minDistillingForGlobalBoost` integer, nullable — Minimum distilling users before disabling global boost. When distilling count is below this, GlobalBoostLevel is set above zero.
  - `graduationRule` union
    - object
      - `_t` 'ScoreThreshold', required
      - `graduationScore` number, double, required
      - `demotionScore` number, double, nullable
      - `minResponsesToGraduate` integer, nullable
    - object
      - `_t` 'TaskAccuracy', required
      - `targetAccuracy` number, double, required
      - `minTasks` integer, required
      - `maxTasks` integer, nullable
  - `maxDistillingResponses` integer, nullable — Maximum responses before user exits the distilling campaign. Set to null to disable this exit condition.
  - `dropMinResponses` integer, nullable — Minimum responses before the drop score check applies. Users need at least this many responses before they can be kicked out for low score. Set to null to apply drop score check from the first response.
  - `dropScore` number, double, nullable — Score floor - users below this score exit the distilling campaign (only after completing DropMinResponses). Set to null to disable this exit condition.
  - `maxDistillingSessions` integer, nullable — Maximum sessions (rapid retrievals) before user exits the distilling campaign. Set to a value to enable session-based exit condition.
  - `inactivityDropDays` integer, nullable — Number of days of inactivity before a distilling user is dropped. Set to null to disable this exit condition.
  - `minSubmissionRate` number, double, nullable — Minimum submission rate (responses / sessions) before a user is dropped. Set to null to disable this exit condition.
  - `minSessionsForSubmissionRate` integer, nullable — Minimum number of sessions before the submission rate check applies. Set to null to apply from the first session.
  - `minSubmissionRateGraduated` number, double, nullable — Minimum submission rate for graduated users. If null, MinSubmissionRate applies to graduated users. Set a lower value to be more lenient with graduated users.
  - `distillingRetrievalMode` 'Random' | 'Shuffled' | 'Sequential'

## Response `200`

OK

- UpdateAudienceEndpointOutput
  - `recalculationId` string, nullable — The id of the audience state recalculation that was dispatched as a result of this update. Only populated when state-affecting parameters (e.g. graduation score, drop score) changed; null when the update only touched descriptive fields or boost configuration.
  - `inactivitySyncId` string, nullable — The id of the audience inactivity sync that was dispatched as a result of this update. Only populated when InactivityDropDays was changed to a non-null value; null otherwise.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

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