post
https://sandbox-api.viantinc.com/{basePath}/creative/assignToAdOrders
Assign Creatives to Ad Orders
Request
POST /creative/assignToAdOrders
Request Body
| Name | Type | Description | Required |
|---|---|---|---|
| entityIds | Number Array | Ad Order IDs to assign the creatives to. | Yes |
| creativeIds | Number Array | Creative IDs to assign to the ad orders. | Yes |
Response
| JSON Fields | Type | Description |
|---|---|---|
| messages | Object Array | An array of any error messages. |
| messages[].level | String | Error level. |
| messages[].code | String | Error code. |
| messages[].message | String | Error message. |
| entity | Object Array | Contains results per Ad Order. |
| entity[].entityId | Number | Ad order ID. |
| entity[].results | Object Array | Assignment info for the Ad Order. Empty if all creatives were already assigned. |
| entity[].results[].creativeId | Number | Creative ID. |
| entity[].results[].result | String |
Assignment result. Possible values:
|
Example
Request to assign creatives to multiple ad orders
curl -u <user>:<password> -X POST -H "Content-Type: application/json" -d '{"entityIds":[145,468652],"creativeIds":[1190,1245219]}' https://sandbox-api.viant.com/v1/creative/assignToAdOrders
Response
{
"messages": [],
"entity": [
{
"entityId": 145,
"results": [
{
"creativeId": 1190,
"result": "CHANNEL_MISMATCH"
}
]
},
{
"entityId": 468652,
"results": []
}
]
}