Apply one operation to up to 1,000 domains in a single request

Requires a signed-in session and ownership of the domains. Free ops (lock, unlock, setNameservers, setFolder, setContacts) fan out asynchronously and return a bulkOpId to track; setAutoRenew updates locally; renew/restore add all items to the cart for one checkout.

post/api/domains/bulk/{op}

Request

  • Base URL: https://name.ai
  • URL: https://name.ai/api/domains/bulk/{op}
  • Auth: API key in cookie next-auth.session-token

Path parameters

op'lock' | 'unlock' | 'setNameservers' | 'setFolder' | 'setContacts' | 'setAutoRenew' | 'renew' | 'restore' required

Request body

domainsstring[] required
payloadobject

Op-specific params, e.g. {"nameservers": [...]}, {"years": 1}, {"reason": "..."}.

Response

Accepted for processing (free ops), applied (setAutoRenew), or added to cart (renew/restore). Deprecation/Sunset/Link headers appear only once the operation is deprecated (see x-deprecation-policy).

OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.