post

/audience_segments/{taxonomy_id}

With a taxonomy ID (obtained from creating a new taxonomy), you can update the taxonomy, change permissions, and add or remove audience segments.

NOTE: you must always post the entire taxonomy when updating a taxonomy.

To ensure that the entire taxonomy is correct, we recommend updates be done as a 3-step process:

  1. GET the existing taxonomy (see example API response with definitions)
  2. Identify & make changes (i.e. add/edit permissions, add/remove leaf nodes, change retail CPMs, etc)
  3. POST the updated taxonomy

Authorization

oauth2 - password

Request Parameters

1 Path Parameter
1 Header

Request Body

Schema
object
audience_vendor_id
integer
required
permissions
object
taxonomy
object
required
use_hash
boolean

If you are using a segment code that is not a 32-bit integer, you’d have to pass an optional parameter use_hash:true as part of the JSON body.

1 validation

Responses

1 Example
Schema
object
data
object
meta
object

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
Path Params
1 path param not set
taxonomy_id
$$.env
1 variable not set
oauth_access_token