Internal DNS

`GET /internal/nodes/{node_id}/dns/changes?since=N`

get/internal/nodes/{node_id}/dns/changes

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/internal/nodes/{node_id}/dns/changes
  • Auth: none declared

Path parameters

node_idinteger required

Node id, must match the bearer token's node

Query parameters

sinceinteger

Highest generation the agent has already applied. Pass 0 to request a full zone snapshot. Defaults to 0 if omitted.

Response

Diff or full snapshot

full_snapshotboolean required

true ⇒ replace the local zone with records. false ⇒ merge records into the existing zone (and remove removed_ids).

generationinteger required

Highest generation included in this response. Agent ACKs this back.

removed_idsinteger[] required

IDs the agent should remove from its zone. Always empty in the v1 protocol — the resolver reconciles by name on snapshot mode. Kept in the wire format so a future tombstone-based protocol doesn't require a breaking change.

Changes

No recorded changes to this operation across all 53 revisions of this API.