Change DNS records in a batch

POST /api/services/cloudflare/zones/{zoneId}/dns/batch on the Vigilbase One API.

Needs a recent sign-in

POST/api/services/cloudflare/zones/{zoneId}/dns/batch

One accepts this request only with a recent sign-in; renewing a token doesn't count, and MCP sessions and API keys are always refused. See changes that need a recent sign-in.

Authorizations

AuthorizationstringAccess tokenheaderrequired

Bearer access token from Vigilbase Identity (auth.vigilbase.com), sent as Authorization: Bearer <token>. The CLI gets one with vigilbase login. Organisation API keys can't call this endpoint: it needs a recent sign-in by a person.

Path Parameters

zoneIdstringrequired

Query Parameters

customerIdstring

Body

application/json

operationIdstringuuidrequired

recordsobject[]required

min 1 itemsmax 1000 items

7 child attributes

typestringrequired

One of:AAAAACNAMEMXTXTNSSRVCAAPTR

namestringrequired

min length 1

contentstring

min length 1

ttlinteger

Default:3600minimum 1maximum 86400

priorityinteger

minimum 0maximum 65535

proxiedboolean

Default:false

dataobject

4 child attributes

priorityintegerrequired

minimum 0maximum 65535

weightintegerrequired

minimum 0maximum 65535

portintegerrequired

minimum 0maximum 65535

targetstringrequired

min length 1

Response

Success

# Token from `vigilbase login`. API keys can't call this.
curl --request POST \
  --url 'https://one.vigilbase.com/api/services/cloudflare/zones/{zoneId}/dns/batch' \
  --header "Authorization: Bearer $VIGILBASE_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"operationId":"<uuid>","records":[{"type":"A","name":"<string>","content":"<string>","ttl":3600,"priority":123,"proxied":false,"data":{"priority":123,"weight":123,"port":123,"target":"<string>"}}]}'

Set VIGILBASE_TOKEN to an Identity access token first, or use Try it.

Responses

200Success

401Authentication required

403Not permitted

The catalog doesn't include example response bodies for this endpoint.

Was this page helpful?