Verify Account Custom Nameserver Glue Records

POST

https://api.cloudflare.com/client/v4/accounts/{identifier}/custom_ns/verify

Last modified:2022-12-16 13:48:32

Request

Path Params

identifier

string

required

Body Params application/json

object {0}

Example

{}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//custom_ns/verify' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Responses

🟢200Verify Account Custom Nameserver Glue Records response

application/json

Body

result

required

Any of

allOf {2}

array[object (Custom NS) {4}]

allOf {2}

One of

array[object (Custom NS) {4}]

object

dns_records

array [object {2}]

required

A and AAAA records associated with the nameserver.

ns_name

string <hostname>

ns_name

required

The FQDN of the name server.

Example:

ns1.example.com

status

enum<string>

required

Verification status of the nameserver.

Allowed values:

movedpendingverified

Example:

verified

zone_tag

string

common_components-schemas-identifier

read-onlyrequired

Identifier

<= 32 characters

Example:

023e105f4ecef8ad9ca31a8372d0c353

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

result_info

object

result_info

optional

count

number

optional

Total number of results for the requested service

Example:

page

number

optional

Current page within paginated list of results

Example:

per_page

number

optional

Number of results per page of results

Example:

total_count

number

optional

Total results available without any search parameters

Example:

2000

Example

{
    "errors": [],
    "messages": [],
    "result": [
        {
            "dns_records": [
                {
                    "type": "A",
                    "value": "1.1.1.1"
                }
            ],
            "ns_name": "ns1.example.com",
            "status": "verified",
            "zone_tag": "023e105f4ecef8ad9ca31a8372d0c353"
        }
    ],
    "success": true,
    "result_info": {
        "count": 1,
        "page": 1,
        "per_page": 20,
        "total_count": 2000
    }
}

🟢200Verify Account Custom Nameserver Glue Records response failure

Modified at 2022-12-16 13:48:32

Get Eligible Zones for Account Custom Nameservers

Delete Account Custom Nameserver