---
title: "Update Single Audience"
method: PUT
path: "/v1/audiences/{id}"
tags: ["Contact Management"]
---

# Update Single Audience

`PUT /v1/audiences/{id}`

## Request body

- AudiencePutRequestDto
  - `data` object, required
    - `name` string, required — Name (unique identifier) of the audience. Maximum 45 characters

## Response `200`

OK

- AudienceResponseWrapperDto
  - `data` object
    - `id` string, uuid — Unique identifier of the audience
    - `account_id` string, uuid — Unique identifier of the account
    - `name` string — Name (unique identifier) of the audience
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP' — Channel of the audience. Enumeration values [SMS, VIBER, WHATSAPP]
    - `create_date` string, date-time — Creation date of the audience in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time — Update date of the audience in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `status` 'PENDING' | 'READY' — Status of the audience. Enumeration values [PENDING, READY]
    - `contacts_count` integer — Saved contacts count
    - `total_contacts` integer — Initial contacts count
    - `valid_contacts` integer — Valid contacts count
    - `duplicate_contacts` integer — Duplicate contacts count
    - `links` object
      - `self` string — URL of the requested resource
      - `account` string — URL of the account
      - `contacts` string — URL of the contact

## Other responses

- `400` — **Bad Request:** Code Message Description 1302 Invalid audience identifier Should be valid UUID
- `404` — **Bad Request:** Code Message Description 1303 'data.audience' name is required Audience name is required 1304 'data.name' is invalid Only letters, numbers, and (- \_) are allowed 1305 'data.name' is too long Audience Name must be at most 45 characters
- `409` — **Conflict:** Code Message 1309 Audience already exists

---

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