Create list items - Cloudflare

Appends new items to the list.

This operation is asynchronous. To get current the operation status, invoke the Get bulk operation status endpoint with the returned operation_id.

Request

Path Params

list_id

string

required

account_identifier

string

required

Body Params application/json

array [oneOf]

optional

object

optional

comment

string

item_comment

optional

An informative summary of the list item.

Example:

Private IP address

string

item_ip

required

An IPv4 address, an IPv4 CIDR, or an IPv6 CIDR. IPv6 CIDRs are limited to a maximum of /64.

Example:

10.0.0.1

redirect

object

item_redirect

optional

The definition of the redirect.

object

optional

comment

string

item_comment

optional

An informative summary of the list item.

Example:

Private IP address

string

item_ip

optional

An IPv4 address, an IPv4 CIDR, or an IPv6 CIDR. IPv6 CIDRs are limited to a maximum of /64.

Example:

10.0.0.1

redirect

object

item_redirect

required

The definition of the redirect.

Example

[
    {}
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Create list items response

application/json

Body

allOf {2}

optional

object (api-response-collection)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

result_info

object

result_info

optional

object

optional

result

object

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "0": null,
        "operation_id": "4da8780eeb215e6cb7f48dd981c4ea02"
    },
    "success": true,
    "result_info": {
        "count": 1,
        "page": 1,
        "per_page": 20,
        "total_count": 2000
    }
}

🟢200Create list items response failure