{"@context": "https://schema.org", "@type": "WebAPI", "name": "PowerDNS Authoritative HTTP API API", "description": "PowerDNS Authoritative HTTP API, an HTTP API described by an OpenAPI document.", "provider": {"@type": "Organization", "name": "powerdns.local"}, "documentation": "https://raw.githubusercontent.com/PowerDNS/pdns/master/docs/http-api/swagger/authoritative-api-swagger.yaml"}
Index / APIs / powerdns.local

PowerDNS Authoritative HTTP API API

PowerDNS Authoritative HTTP API, an HTTP API described by an OpenAPI document.

Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.

Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.

auth: a p i k e y

find it by capability: POST /search {"query":{"text":"..."}} returns these operations with their invocation detail. Connect any agent client.

PowerDNS Authoritative HTTP API v0.0.13

PowerDNS Authoritative HTTP API, an HTTP API described by an OpenAPI document.

methodpathwhat the vendor says it does
GET/serversList all servers servers
GET/servers/{server_id}List a server servers
PUT/servers/{server_id}/cache/flushFlush a cache-entry by name servers
GET/servers/{server_id}/configReturns all ConfigSettings for a single server config
GET/servers/{server_id}/config/{config_setting_name}Returns a specific ConfigSetting for a single server NOT IMPLEMENTED config
GET/servers/{server_id}/search-dataSearch the data inside PowerDNS Search the data inside PowerDNS for search_term and return at most max_results
GET/servers/{server_id}/statisticsQuery statistics. Query PowerDNS internal statistics. stats
GET/servers/{server_id}/tsigkeysGet all TSIGKeys on the server, except the actual key tsigkey
POST/servers/{server_id}/tsigkeysAdd a TSIG key This methods add a new TSIGKey. The actual key can be generated by the server or be provided by
GET/servers/{server_id}/tsigkeys/{tsigkey_id}Get a specific TSIGKeys on the server, including the actual key tsigkey
PUT/servers/{server_id}/tsigkeys/{tsigkey_id}The TSIGKey at tsigkey_id can be changed in multiple ways: * Changing the Name, this will remove the key with
DELETE/servers/{server_id}/tsigkeys/{tsigkey_id}Delete the TSIGKey with tsigkey_id tsigkey
GET/servers/{server_id}/zonesList all Zones in a server zones
POST/servers/{server_id}/zonesCreates a new domain, returns the Zone on creation. zones
GET/servers/{server_id}/zones/{zone_id}zone managed by a server zones
PUT/servers/{server_id}/zones/{zone_id}Modifies basic zone data. The only fields in the zone structure which can be modified are: kind, masters, acco
PATCH/servers/{server_id}/zones/{zone_id}Creates/modifies/deletes RRsets present in the payload and their comments. Returns 204 No Content on success.
DELETE/servers/{server_id}/zones/{zone_id}Deletes this zone, all attached metadata and rrsets. zones
PUT/servers/{server_id}/zones/{zone_id}/axfr-retrieveRetrieve slave zone from its master. Fails when zone kind is not Slave, or slave is disabled in the configurat
GET/servers/{server_id}/zones/{zone_id}/cryptokeysGet all CryptoKeys for a zone, except the privatekey zonecryptokey
POST/servers/{server_id}/zones/{zone_id}/cryptokeysCreates a Cryptokey This method adds a new key to a zone. The key can either be generated or imported by suppl
GET/servers/{server_id}/zones/{zone_id}/cryptokeys/{cryptokey_id}Returns all data about the CryptoKey, including the privatekey. zonecryptokey
PUT/servers/{server_id}/zones/{zone_id}/cryptokeys/{cryptokey_id}This method (de)activates a key from zone_name specified by cryptokey_id zonecryptokey
DELETE/servers/{server_id}/zones/{zone_id}/cryptokeys/{cryptokey_id}This method deletes a key specified by cryptokey_id. zonecryptokey
GET/servers/{server_id}/zones/{zone_id}/exportReturns the zone in AXFR format. zones
GET/servers/{server_id}/zones/{zone_id}/metadataGet all the Metadata associated with the zone. zonemetadata
POST/servers/{server_id}/zones/{zone_id}/metadataCreates a set of metadata entries Creates a set of metadata entries of given kind for the zone. Existing metad
GET/servers/{server_id}/zones/{zone_id}/metadata/{metadata_kind}Get the content of a single kind of domain metadata as a Metadata object. zonemetadata
PUT/servers/{server_id}/zones/{zone_id}/metadata/{metadata_kind}Replace the content of a single kind of domain metadata. Creates a set of metadata entries of given kind for t
DELETE/servers/{server_id}/zones/{zone_id}/metadata/{metadata_kind}Delete all items of a single kind of domain metadata. zonemetadata
PUT/servers/{server_id}/zones/{zone_id}/notifySend a DNS NOTIFY to all slaves. Fails when zone kind is not Master or Slave, or master and slave are disabled
PUT/servers/{server_id}/zones/{zone_id}/rectifyRectify the zone data. This does not take into account the API-RECTIFY metadata. Fails on slave zones and zone

specification origin: https://raw.githubusercontent.com/PowerDNS/pdns/master/docs/http-api/swagger/authoritative

nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.