Skip to content
Topsort Documentation
API

Update Audience

PUT
/v1/audiences/{audience-key}

Update an audience.

Authentication

Topsort’s APIs are authenticated via bearer tokens. Requests must include an authorization header containing your private API key.

Don't have an API key yet? Learn how to generate one.

Authorization
required
string

The header containing a private API key. Format this header as follows:

Authorization: Bearer <YOUR-API-KEY>

Path Parameters

object
audience-key
required

Audience key to update.

string

Audience key to update.

Request Body

Audiences to update.

application/json
object
audienceValues
required

New audience values.

Array<string>

Responses

Successful Response

Represents an audience.

application/json
object
audienceKey
required

Unique identifier for categorizing audiences.

string
>= 2 characters <= 25 characters /^\w+$/
audienceValues
required

List of specific values under this category.

Array<string>
>= 1 items
createdAt
required

Datetime of when the audience was created.

string format: date-time
updatedAt
required

Datetime of the audience’s last update.

string format: date-time