place.wisp.v2.domains

wisp.place

Documentation

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

main record

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

Record Key any Any valid record key

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

domain string Required

Lowercase FQDN for this registration (for example, alice.wisp.place or example.com).

maxLength: 253 bytesminLength: 3 bytes
siteRkey string record-key Optional

Optional place.wisp.fs record key currently mapped to this domain.

updatedAt string datetime Required

An RFC 3339 formatted timestamp.

View raw schema 
{
  "description": "Domain registration metadata for wisp.place subdomains and custom domains.",
  "key": "any",
  "record": {
    "properties": {
      "createdAt": {
        "format": "datetime",
        "type": "string"
      },
      "domain": {
        "description": "Lowercase FQDN for this registration (for example, alice.wisp.place or example.com).",
        "maxLength": 253,
        "minLength": 3,
        "type": "string"
      },
      "registration": {
        "refs": [
          "#wispRegistration",
          "#customRegistration"
        ],
        "type": "union"
      },
      "siteRkey": {
        "description": "Optional place.wisp.fs record key currently mapped to this domain.",
        "format": "record-key",
        "type": "string"
      },
      "updatedAt": {
        "format": "datetime",
        "type": "string"
      }
    },
    "required": [
      "domain",
      "registration",
      "createdAt",
      "updatedAt"
    ],
    "type": "object"
  },
  "type": "record"
}
customRegistration object

Registration metadata for a custom domain.

Properties

challengeId string Required

Challenge identifier used to derive DNS setup instructions.

maxLength: 64 bytesminLength: 8 bytes
kind string Required

No description available.

verification ref #verification Required

No description available.

View raw schema 
{
  "description": "Registration metadata for a custom domain.",
  "properties": {
    "challengeId": {
      "description": "Challenge identifier used to derive DNS setup instructions.",
      "maxLength": 64,
      "minLength": 8,
      "type": "string"
    },
    "kind": {
      "const": "custom",
      "type": "string"
    },
    "verification": {
      "ref": "#verification",
      "type": "ref"
    }
  },
  "required": [
    "kind",
    "challengeId",
    "verification"
  ],
  "type": "object"
}
verification object

Latest verification state for a custom domain.

Properties

lastCheckedAt string datetime Optional

An RFC 3339 formatted timestamp.

lastError string Optional

No description available.

maxLength: 1000 bytes
method string Required

No description available.

status string Required

No description available.

verifiedAt string datetime Optional

An RFC 3339 formatted timestamp.

View raw schema 
{
  "description": "Latest verification state for a custom domain.",
  "properties": {
    "lastCheckedAt": {
      "format": "datetime",
      "type": "string"
    },
    "lastError": {
      "maxLength": 1000,
      "type": "string"
    },
    "method": {
      "enum": [
        "txt-did-v1"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "pending",
        "verified",
        "failed"
      ],
      "type": "string"
    },
    "verifiedAt": {
      "format": "datetime",
      "type": "string"
    }
  },
  "required": [
    "status",
    "method"
  ],
  "type": "object"
}
wispRegistration object

Registration for a first-party subdomain under the wisp.place base host.

Properties

handle string Required

Subdomain label only (for example, alice).

maxLength: 63 bytesminLength: 3 bytes
kind string Required

No description available.

View raw schema 
{
  "description": "Registration for a first-party subdomain under the wisp.place base host.",
  "properties": {
    "handle": {
      "description": "Subdomain label only (for example, alice).",
      "maxLength": 63,
      "minLength": 3,
      "type": "string"
    },
    "kind": {
      "const": "wisp",
      "type": "string"
    }
  },
  "required": [
    "kind",
    "handle"
  ],
  "type": "object"
}

Lexicon Garden

@