Allocate Domains to DNS Shield

Testing

POST

/v2/dns-shield/allocate-domains

Allocate domains to your DNS Shield LTD subscription slots and enable DNS Shield protection. This endpoint assigns specific domains to your available LTD plan capacity and automatically configures DNS Shield protection.

Request

Header Params

Body Params application/jsonRequired

Example

{
  "domainIds": [
    ""
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zapmail.ai/api/v2/dns-shield/allocate-domains' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-key;' \
--header 'x-service-provider;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "domainIds": [
    ""
  ]
}'

Responses

🟢200Success

application/json

Body

Example

{
  "status": 200,
  "message": "Domains allocated to DNS Shield successfully",
  "data": {
    "success": true,
    "allocated": 25,
    "remaining": 0,
    "allocations": [
      {
        "domainId": "a66ccca7-d465-464a-887b-90bce6d09bbb",
        "subscriptionId": "sub-uuid-1"
      },
      {
        "domainId": "b77dddb8-e576-575b-998c-01cdf7e10ccc",
        "subscriptionId": "sub-uuid-1"
      },
      {
        "domainId": "c88eeeec9-f687-686c-aa9d-12def8f21ddd",
        "subscriptionId": "sub-uuid-2"
      }
    ],
    "errors": []
  }
}

Modified at 2025-12-24 13:03:22

Get Allocated Domains for Subscription

Purchase DNS Shield