post
https://sandbox-api.viantinc.com/{basePath}/site-list/overwriteSiteList
Overwrite sites of an existing site list.
Request
POST /site-list/overwriteSiteList
Request Body
| Name | Type | Description | Required |
|---|---|---|---|
| id | Number | Site list id | Yes |
| name | String | Site list name | Yes |
| siteIds | Number Array | Sites overwrite to site list | Yes, if overwrite sites to id based sitelist |
| rules | Object Array | An array of rules to overwrite the site list | Yes, if overwrite rules to rule based sitelist |
| rules[].name | String | Rule name | Yes, if rules based |
| rules[].type | String | Sites type i.e, web or app | Yes, if rules based |
Response
| Name | 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 | A site list object |
| entity.id | Number | Site list id |
| entity.name | String | Site list name |
| entity.typeId | Number | Site list type i.e., id based or rule based |
| entity.strategy | String | Site list strategy i.e., broad or precise |
| entity.siteIds | Number Array | Site ids associated to ID based site list. Should be null for rule based ones |
| entity.rules | Object Array | Site list rules for rule based ones |
| entity.rules[].name | String | Site name added to site list |
| entity.rules[].type | String | Site type |
| entity.insertedCount | Number | Number of sites overwrite to sitelist i.e., in id based or rule based |
Examples
Request to overwrite sites to Id based site list
curl -u \<user>:\<password> -X POST -H "Content-Type: application/json" -d '\{"id":8964,"name":"Viant\_IDBased\_SiteList","siteIds":\[443109,497080]}' https\://sandbox-api.viant.com/v1/site-list/overwriteSiteList
Response
{
"messages":[],
"entity":
{
"id":8964,
"name":"Viant_IDBased_SiteList",
"typeId":5,
"strategy":null,
"siteIds":null,
"rules":null,
"insertedCount":2
}
}
Request to overwrite sites to rule based site list
curl -u \<user>:\<password> -X POST -H "Content-Type: application/json" -d '"id":6004,"name":"test1","rules":\[\{"name":"oracle.at.ua","type":"web"},\{"name":"java.com","type":"app"}]}' https\://sandbox-api.viant.com/v1/site-list/overwriteSiteList
Response
{
"messages":[],
"entity":
{
"id":6004,
"name":"test1",
"typeId":1,
"strategy":"precise",
"siteIds":null,
"rules":null,
"insertedCount":2
}
}