place.wisp.v2.domain.claim

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

Repository @wisp.place did:plc:7puq73yz2hkvbcpdhnsze2qw not from the namespace authority
Details · procedure
Kindprocedure
Authoritydomain.v2.wisp.place
Indexed

Procedure

procedure · POST

Input

application/json

domain

requiredstring

Custom domain FQDN to claim (for example, example.com).

  • minLength: 3
  • maxLength: 253

siteRkey

string · record-key

Optional place.wisp.fs rkey to map immediately after claim.

Output

application/json

Identifier used to construct DNS challenge targets for custom domains.

  • minLength: 8
  • maxLength: 64

Advisory CNAME target (custom domains).

  • minLength: 3
  • maxLength: 253

domain

requiredstring

kind

string
  • enum: custom

siteRkey

string · record-key

status

requiredstring
  • enum: alreadyClaimed | pendingVerification | verified

txtName

string

TXT hostname to set for ownership proof (custom domains).

  • minLength: 3
  • maxLength: 253

txtValue

string · did

TXT value to set for ownership proof (custom domains).

Errors

AuthenticationRequired

No description in schema.

InvalidDomain

No description in schema.

AlreadyClaimed

No description in schema.

DomainLimitReached

No description in schema.

RateLimitExceeded

No description in schema.

Similar lexicons

semantic match

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

  • place.wisp.v2.domain.claimSubdomain

    procedure not from the namespace authority

    Claim a wisp.place subdomain handle for the authenticated DID.

  • place.wisp.v2.domain.verify

    procedure not from the namespace authority

    Run DNS verification for a custom domain owned by the authenticated DID and update its verified status.

  • place.wisp.v2.domains

    record not from the namespace authority

    Domain registration metadata for wisp.place subdomains and custom domains.

  • Set or update the custom domain for a publication. Returns a verification token that must be installed as a TXT record before calling verify.

  • Add a custom domain to one of the caller's instances. It starts pending, with the DNS records to publish. Customers only.