Provisioning

Is a domain being registered for this account?

The other half of the 409 DOMAIN_PROVISIONING that POST /v1/hostnames returns while a domain is still being bought. That response says to retry shortly; this says when retrying will work, so a caller does not have to poll the write endpoint to find out. Reports only: reading it buys, claims and promotes nothing, so a polling loop cannot become a spending loop.

get/v1/provisioning

Request

  • Base URL: https://dnsmint.com/api
  • URL: https://dnsmint.com/api/v1/provisioning
  • Auth: apiKey (a scheme the document does not define)

Response

The state of the newest domain bought for this account.

state'none' | 'provisioning' | 'ready' | 'claimed' required

none: nothing is being bought, so retrying will not help. provisioning: a domain is being set up for this team. ready: bought and delegated, waiting to be claimed. claimed: assigned to this account, so minting works.

domainstring

The domain bought for this account, when there is one.

sincestring date-time

When it was registered, so a caller can show how long it has been.

delegatedboolean

Whether public DNS shows our nameservers yet.

retry_afterinteger required

Seconds to wait before asking again. Zero when there is nothing to wait for.

Changes

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