space.highport.manage.setDomainBilling

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Set whose allowance a domain's traffic draws on. Changing payerPolicy revokes every visitor approval the domain holds: consent was given to a different arrangement. The owner always remains the residual payer.",
      "errors": [
        {
          "description": "Not a syntactically valid, non-reserved, public-suffix-safe domain. Distinct from DomainNotFound: the string is not a hostname at all.",
          "name": "InvalidDomain"
        },
        {
          "description": "No such domain, or it is not registered to the calling identity.",
          "name": "DomainNotFound"
        },
        {
          "description": "payerPolicy is not one of owner or visitor.",
          "name": "InvalidRequest"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "domain": {
              "description": "The registered hostname. Must be registered to the calling identity.",
              "maxLength": 253,
              "type": "string"
            },
            "fallbackToOwner": {
              "default": true,
              "description": "Under the visitor policy, whether a visitor with nothing left falls back to the owner rather than being refused. True is what stops a site going dark because one visitor overspent.",
              "type": "boolean"
            },
            "ownerBudgetBytes": {
              "description": "Bytes of the owner's own allowance this site may spend on readers who have not signed in, per period. 0 requires a sign-in before anything is served; omitted leaves payerPolicy and fallbackToOwner in charge. When present it derives both.",
              "minimum": 0,
              "type": "integer"
            },
            "payerPolicy": {
              "description": "owner: every byte draws on the domain owner's allowance. visitor: authenticated visitors spend their own, and the owner pays for anonymous traffic and for visitors with nothing left.",
              "knownValues": [
                "owner",
                "visitor"
              ],
              "type": "string"
            },
            "visitorCapBytes": {
              "description": "A ceiling on what any single visitor may spend here per period. Absent means no ceiling beyond the one the visitor themselves set.",
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "domain",
            "payerPolicy"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "approvalsRevoked": {
              "description": "How many visitor approvals the policy change invalidated.",
              "type": "integer"
            },
            "billing": {
              "description": "Whose allowance a domain's traffic draws on.",
              "properties": {
                "domain": {
                  "description": "The domain.",
                  "type": "string"
                },
                "fallbackToOwner": {
                  "description": "Under the visitor policy, whether a visitor with nothing left falls back to the owner rather than being refused.",
                  "type": "boolean"
                },
                "ownerBudgetBytes": {
                  "description": "Bytes of the owner's own allowance this site may spend on readers who have not signed in, per period. 0 requires a sign-in before anything is served; omitted leaves payerPolicy and fallbackToOwner in charge. When present it derives both.",
                  "minimum": 0,
                  "type": "integer"
                },
                "payerPolicy": {
                  "description": "owner or visitor.",
                  "knownValues": [
                    "owner",
                    "visitor"
                  ],
                  "type": "string"
                },
                "updatedAt": {
                  "description": "When it last changed. Absent when the domain has no arrangement recorded and is reporting the default.",
                  "format": "datetime",
                  "type": "string"
                },
                "visitorCapBytes": {
                  "description": "A ceiling on what any single visitor may spend here per period.",
                  "type": "integer"
                }
              },
              "required": [
                "domain",
                "payerPolicy",
                "fallbackToOwner"
              ],
              "type": "object"
            }
          },
          "required": [
            "billing"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "id": "space.highport.manage.setDomainBilling",
  "lexicon": 1
}