Buy the quoted name (a person only) and connect it

Before you call

Credential

Authorization: Bearer $KEY

Scope

hosting:write

Graphql

Mutation.hostingDomainBuy

Sdk

hosting.domain.buy

Cli

hosting domain buy

Events

hosting.domain.bought

Parameters

• idstring (uuid)required
  In the path

Request bodyapplication/json, required

• tokenstringrequired
  At most 80 characters.

Responses

• 201application/json
  Success
  • registeredUntilstring or null
  • idstring (uuid)required
  • projectIdstringrequired
  • hoststringrequired
  • wildcardbooleanrequired
  • methodstringrequired
    One of: buy, delegation, connector, domain_connect, watch.
  • statestringrequired
    One of: pending_dns, verifying, issuing, live, degraded, suspended.
  • reasonstringrequired
  • nextobject or nullrequired
  • certificatestringrequired
    One of: pending, issued, failed.
  • certExpiresAtstring or nullrequired
  • targetstringrequired
  • canonicalstringrequired
    One of: www, apex.
  • verifiedAtstring or nullrequired
  • liveAtstring or nullrequired
  • checkedAtstring or nullrequired
  • createdAtstringrequired
• 400application/json
  The request was malformed
  • errorstringrequired
  • messagestring
• 401application/json
  No valid credential
  • errorstringrequired
  • messagestring
• 403application/json
  The credential lacks the scope, origin or address
  • errorstringrequired
  • messagestring
• 429application/json
  Over the key's rate limit; see Retry-After
  • errorstringrequired
  • messagestring