Lexicon Garden

space.highport.manage.register

Register a domain to the caller, or to a space the caller is the authority of, and get the DNS records needed to prove ownership and route traffic.

Repository @lexicons.highport.space did:plc:ciygg5hma4q7ah2kxaszkyob namespace authority
Details · procedure
Kindprocedure
Authoritymanage.highport.space
Indexed

Showing version bafyreif7tb7mqd5e5xoynypsylewvsijhjyn2bkdythyugsvs6mw3bzcsi. Show the latest

Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

domain

requiredstring
  • maxLength: 253

space

string · at-uri

Register the domain to this space instead of the caller's public repo. Bard must be connected to the space, and the caller must be its authority.

Output

application/json

domain

requiredstring

expiresAt

requiredstring · datetime

An unverified registration is released after this time.

records

requiredarray

space

string · at-uri

Errors

InvalidDomain

Not a valid, non-reserved, public-suffix-safe domain.

DomainTaken

The domain is taken: registered to a different DID and verified, active or suspended; reserved under a base for a different DID; or released while its wildcard grant is still being retired, which blocks everyone, the previous holder included.

DomainDenied

The domain is on the operator denylist.

QuotaExceeded

This DID has reached its domain limit.

AlreadyRegistered

Already registered to this DID. Use getDomain to get the instructions again.

SpaceNotFound

Bard is not connected to that space. Call connectSpace first.

NotSpaceAuthority

Only the space's authority may register a domain to it.

SpaceNotSynced

Registered, but bard cannot read the space right now, so the domain will not serve until it can.

DomainDelegated

The domain is under a delegation base. Only the base's owner can hand out names there, with reserveDomain.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • space.highport.manage.reserveDomain

    procedure

    Reserve a name directly under a delegation base for another identity. The name answers /.well-known/atproto-did with the subject right away, and the subject can then publish a site there. The caller must own the base. Any unproven claim on the name is replaced. Repeating the call for the same subject returns the existing reservation and does not count against maxNames. Reservations last as long as the base.

  • space.highport.manage.getDomain

    query

    Everything a client needs to onboard one domain: registration state, DNS records to publish, last verification result, and certificate state. This is the endpoint to poll.

  • space.highport.manage.enableDelegation

    procedure

    Make a registered domain a delegation base, so its owner can reserve names directly under it for other identities. Returns the wildcard record that routes those names. The caller must own the base, and it must be verified or active.

  • space.highport.sites.resolveDomain

    query

    Look up which identity and record serve a domain. Useful for checking who owns a site.

  • place.wisp.v2.domain.claim

    procedure not from the namespace authority

    Claim a custom domain for the authenticated DID. Returns DNS setup instructions.