Client area

POST · Domains

Enable or disable auto-renewal for a domain

Enable or disable auto-renewal for a domain

POST /api/v1/domains/{domain}/autorenew
W Write

Description

Sets whether the domain renews automatically at expiry. It does not renew now — for a price and a new expiry use renew_domain. Returns the new autorenew state and the target; with inputs, {enabled, items[], changed, failed}.

Path parameters

Name Type Description
domain required string

Body

Send as application/json.

Name Type Description
input string A domain, email address, website URL, or Inleed service id — for example example.se, [email protected] or 42976. Resolved to the owning account automatically, and the resolved target is echoed back in the response.
inputs string[] Several domains in one call (2–25 identifiers, each as for input). Each is set independently; a refused one is reported in items[] and never stops the others.
enabled required boolean true to renew automatically at expiry, false to require manual renewal.

Responses

The specification does not describe this response body; the note in the rail says what to expect. Every non-2xx response is an RFC 7807 problem with a stable code.

Commonly returned errors

The codes this operation reaches on its own path: the auth stack, its own validation and ownership checks, and the transport. Not a closed set — a shared code from the full registry can still surface. Each links to the code’s own page, the same URL its type dereferences to.

401 No token was presented, or the token is revoked, expired or unknown.
403 The token lacks a required scope, or this account does not own the resource.
404 No such resource for this account.
422 Validation error
429 The rate limit for this token is exhausted. See `Retry-After`.
500 Something went wrong on our side. The failure is logged against `requestId`.
Esc
navigate open Esc close