Replace placement tags

PUT

/api/nova/placements/{placementId}/tags

Replaces the full tag set of the placement given by the placementId path variable with the tags array supplied in the JSON body; existing tags not in the list are removed. Authenticated by an apiKey query parameter tied to an API user whose visibility rules apply. Returns the placement id with a confirmation message on success. Responds with 400 if the tags field is missing, 404 if the placement is not found or not visible, 401 if the apiKey is invalid, 429 when rate limited, and 500 on unexpected failures.

Authorizations

privateApiKey

Type

API Key (query: apiKey)

Parameters

Path Parameters

placementId*

placementId

Type

string

Required

Query Parameters

apiKey*

apiKey

Type

string

Required

Request Body

application/json

{

  

"tags": [

  

  

{

  

  

  

"group": "string",

  

  

  

"value": "string"

  

  

}

  

]

}

Responses

OK

Content-Type

application/json

{

  

"data": "string",

  

"error": "string",

  

"message": "string",

  

"requestId": "string",

  

"success": true

}

PUT

/api/nova/placements/{placementId}/tags

Playground

Authorization

privateApiKey

Variables

Key

Value

placementId*

apiKey*

Body

Samples