Replace Offsite Audiences job - Topsort Documentation

curl --request PUT \ --url https://api.topsort.com/public/v1/offsite-ads/audiences/{audience-id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "My user list audience", "description": "This is a user list audience description." } '

Autorizaciones

Authorization

string

header

requerido

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Parámetros de ruta

audience-id

string

requerido

The audience ID to replace.

Cuerpo

application/json

name

string | null

Optional updated name of the user list audience.

Minimum string length: 1

Ejemplo:

"My user list audience"

description

string | null

Optional updated description of the user list audience.

Minimum string length: 1

Ejemplo:

"This is a user list audience description."

Respuesta

Accepted

jobId

string<uuid>

requerido

The unique identifier for the queued job.

Ejemplo:

"123e4567-e89b-12d3-a456-426614174000"

url

string

requerido

The presigned url to upload the audience csv file. Presigned url must be used with PUT method and include the header Content-Type: text/csv.

Ejemplo:

"https://offsite-ads-user-list-uploads.s3.us-east-2.amazonaws.com/123e4567-e89b-12d3-a456-426614174000.csv"