Update List

PATCH /lists/{id}

Copied

---

                https://api.ocamba.com/v2/adex/lists/{id}
            

Updates the specific List by setting the values of the parameters passed. Any parameters not provided will be left unchanged

path Parameters

---

Name

Description

idstringrequired

List id.


Example: 1162

Request Body Schema

---

Name

Description

itemslist-items-by-typerequired

Items must be a string, value depends on list type. For examples check list-items-by-type or request example.

List Items

---

Name

Description

categorystring

Category list items must be a string of valid category IDs supported by Ocamba, separated by a comma.


Example: IAB1,IAB11,IAB3

---

countrystring

Country list items must be valid a string of two letter country codes supported by Ocamba, separated by a comma.


Example: RS,DE,JP,GB

---

domainstring

Domain list items must be a string of fully qualified domain names separated by a comma. Domain length must be between 3 and 100 characters.


Example: example.domain.com,another.example.com

---

ipstring

Ip list items must be a string of ip addresses in an ipv4, ipv6 or cidr format for both v4 and v6, separated by a comma.


Example: 192.168.0.1,1.1.1.1,192.168.0.15/28,1.2.3.4,2001:0db8:85a3:33a1:ff12:8a2e:0370:7334/23,2301:0db2:84a3:34a1:ff42:8a1e:0270:7324

---

keywordstring

String containing keywords separated by a comma. Keyword must be a string with minimum length of 3 and maximum of 150, containing max 20 groups separated by \|. Each group can be made up of these characters: a-zA-Z0-9_%!


Example: keyword01!\|keyword02_%,example_keyword|another_example

---

regionstring

Region list item must be a string of region IDs supported by Ocamba, separated by a comma.


Example: 292969,3183560,7581800

---

subidstring

String containing subids separated by a comma. Subid can be any string with length between 1 and 200 characters.


Example: subid_1,subid2,sub_id_3

---

zonestring

Zone list items must be a string of valid zone IDs supported by Ocamba, separated by a comma.


Example: 1314550,1445589,1332565

---

namestringrequired

Represents name of the list.


Example: demo_list

Response status codes

---

204 - No Content

note

1 At least one of the updatable fields should be sent via HTTP body in order to change the current state of the list.

tip

1 If you don't know the list id, list the lists to find it.