API Documentation

Choose which API version you want to use for your dynamic DNS updates

API Version 1

The V1 API is designed for compatibility with DuckDNS and other simple dynamic DNS clients. It uses a single account-wide token that can update any of your domains.

  • DuckDNS compatible API for easy migration
  • Insecure legacy account-wide token
  • Confusing API design
API Version 2

The V2 API provides more granular control with domain-specific tokens and advanced features. Recommended for new integrations and applications requiring fine-grained access control.

  • Secure domain-specific tokens
  • Administer multiple tokens per domain
  • Modern API design
  • Clearer error messages
Quick Start
For DuckDNS Users:

If you're migrating from DuckDNS, use the V1 API and create a legacy token. The V1 API provides the same API interface you are used to.

V1 API Guide
For New Integrations:

If you're building a new application, we recommend the V2 API for better security and more features.

V2 API Guide