GoDaddy Domains v3

Creates a new DNS record in the GoDaddy-managed zone. Changes are applied synchronously; no operation polling required.

Permanently removes a DNS resource record from the zone. The recordId must refer to an existing record within the specified zone. Changes are applied synchronously. GoDaddy-managed system records (SOA and NS) are read-only. When recordId refers to such a record, the request fails with `409 Conflict` — the record exists but cannot be deleted.

Returns the management view of a single registered domain owned by the authenticated account, including status, nameservers, privacy and auto-renew preferences, and expiry date.

Returns an indicative availability result for one domain, including per-term pricing when available. Availability is best-effort; the authoritative check is performed at quote time. This operation does not persist the check — there is no check identity or poll URL. A domain that cannot be checked is still returned as a `200` with an `error` object on the body; request-level failures use the `4xx` responses.

Universal poll endpoint for all asynchronous domain mutations. Returns the current state of the operation. Non-terminal responses include a `Retry-After` header. Terminal statuses: - `COMPLETED` — operation succeeded; `result` contains the final outcome. - `FAILED` — operation terminated with an error; `error` contains detail. While status is non-terminal (`CONFIRMED`, `EXECUTING`), neither `result` nor `error` is present. Poll until a terminal status is reached. The poll URL is provided in the `Location` header of the initiating 202 response and in `links[rel=self]`. Clients must not construct this URL independently.

Returns a single registration record by its server-assigned registrationId, including the current execution status and the domain expiry date once the registration completes. This is the concrete poll endpoint for registration operations; the abstract equivalent is GET /operations/{operationId}.

Returns a paginated collection of DNS resource records for the specified zone. Supports filtering by record type and host name, field projection, and page-based pagination. Pagination uses page (1-based) and pageSize query parameters. Pass totalRequired=true to include totalItems and totalPages when at least one record matches; both are omitted for empty result sets. Defaults to false to avoid count-query overhead. Filter parameters are combined with logical AND. Pagination links in the response preserve active filter, pagination, and field-projection parameters. sortBy and sortOrder are not supported. Results are always returned in canonical zone-file order: resource record type (IANA RR type number ascending — e.g. A before NS before CNAME), then name, then data. This matches authoritative DNS ordering and is not client-configurable.

Prices the registration, resolves contact and preference settings, returns required legal agreements, and mints a single-use quoteToken with a 10-minute TTL. Free and read-only; safe to call speculatively. When the domain is unavailable, `available: false` is returned with no quoteToken — this is a valid non-error response. When required contact fields are missing, a `422` is returned with field-level details so the agent can collect the missing data and re-quote. May pass `iscCode` to lock pricing at applicable rates; the same value must be supplied on /registrations if provided here. The `period` supplied here must be re-supplied on /registrations; a mismatch returns `quote_mismatch`. If `profile` or `profileId` is supplied here, the same value must be re-supplied on /registrations; a mismatch returns `quote_mismatch`.

Executes a previously quoted domain registration. **Irreversible once accepted; creates a charge.** Requires a valid unexpired quoteToken from `quoteDomainRegistration`, an `Idempotency-Key` header, and a consent record. The target domain and period are in the request body alongside the quoteToken. Before calling this endpoint, retrieve `requiredAgreements` from the quote response and review each agreement before submitting the registration. Each agreement includes a `title` (display label) and optional `url` (full legal text). The `consent.agreementTypes` array must contain the `agreementType` value from every item in `requiredAgreements`; a mismatch returns `INVALID_AGREEMENT_KEYS`. Idempotency takes precedence over the single-use check: retrying with the same `Idempotency-Key` replays the original operation even after the token is consumed. Returns a `Registration` entity. Poll `links[rel=self]` (`GET /registrations/{registrationId}`) until status is `COMPLETED` or `FAILED`. The `operationId` field is also provided for clients that prefer `GET /operations/{operationId}`; both resolve the same resource. Poll either until status is `COMPLETED` or `FAILED`. The operation is fire-and-forget; always poll at least once even if the server completed it synchronously. When `iscCode` was supplied at quote time, the same value must be provided here or the request fails with `quote_mismatch`. When `period` was supplied at quote time, the same value must be provided here or the request fails with `quote_mismatch`. When `profile` or `profileId` was supplied at quote time, the same value must be provided here or the request fails with `quote_mismatch`.

Returns available domain name suggestions for a natural-language query or keyword set. All results are available (available-only contract). Prices are indicative; the authoritative price and availability check is at quote time.

Replaces the authoritative nameservers for the domain with the provided list. Minimum 2, maximum 13. Returns a DomainOperation; propagation to the registry is asynchronous.