# API Reference

This section is generated from the source and is intended to document the
**stable contracts** of `dxaws-dns`.

If you are integrating `dxaws-dns` into higher-level orchestration, the primary
entry points are:

- `dxaws_dns.models.DnsRecordDesired` – desired state contract
- `dxaws_dns.models.DnsRecordCurrent` – observed state contract
- `dxaws_dns.manager.DnsManager` – orchestration (normalize → current → plan → apply)
- `dxaws_dns.providers.route53.Route53Provider` – AWS adapter (Route 53)

Notes:

- Call sites should prefer `zone_name`; `zone_id` is optional and may be resolved
  by the manager/provider.
- TXT values may be provided unquoted; the system normalizes to Route 53’s quoted
  form to make diffs stable.

```{toctree}
:maxdepth: 2

api/modules