space.highport.manage.setDomainBilling

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Set whose allowance a domain's traffic uses. Changing payerPolicy revokes every visitor approval on the domain, since visitors agreed to the old arrangement. The owner always pays whatever nobody else covers.",
      "errors": [
        {
          "description": "Not a valid, non-reserved, public-suffix-safe domain. Unlike DomainNotFound, the input is not a hostname at all.",
          "name": "InvalidDomain"
        },
        {
          "description": "No such domain, or it does not belong to the caller.",
          "name": "DomainNotFound"
        },
        {
          "description": "payerPolicy must be owner or visitor.",
          "name": "InvalidRequest"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "domain": {
              "description": "The registered hostname. Must belong to the caller.",
              "maxLength": 253,
              "type": "string"
            },
            "fallbackToOwner": {
              "default": true,
              "description": "Under the visitor policy: whether a visitor who has run out falls back to the owner instead of being refused. True keeps the site up when one visitor overspends.",
              "type": "boolean"
            },
            "ownerBudgetBytes": {
              "description": "How many bytes of the owner's allowance this site may spend per period on readers who are not signed in. 0 requires sign-in for everything. When set, it determines payerPolicy and fallbackToOwner; when omitted, those two apply as set.",
              "minimum": 0,
              "type": "integer"
            },
            "payerPolicy": {
              "description": "owner: all traffic uses the owner's allowance. visitor: signed-in visitors use their own, and the owner pays for anonymous traffic and for visitors who have run out.",
              "knownValues": [
                "owner",
                "visitor"
              ],
              "type": "string"
            },
            "visitorCapBytes": {
              "description": "The most any one visitor can spend here per period. Absent means only the visitor's own cap applies.",
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "domain",
            "payerPolicy"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "approvalsRevoked": {
              "description": "How many visitor approvals the policy change revoked.",
              "type": "integer"
            },
            "billing": {
              "description": "Whose allowance a domain's traffic uses.",
              "properties": {
                "domain": {
                  "description": "The domain.",
                  "type": "string"
                },
                "fallbackToOwner": {
                  "description": "Under the visitor policy: whether a visitor who has run out falls back to the owner instead of being refused.",
                  "type": "boolean"
                },
                "ownerBudgetBytes": {
                  "description": "How many bytes of the owner's allowance this site may spend per period on readers who are not signed in. 0 requires sign-in for everything. When set, it determines payerPolicy and fallbackToOwner; when omitted, those two apply as set.",
                  "minimum": 0,
                  "type": "integer"
                },
                "payerPolicy": {
                  "description": "owner or visitor.",
                  "knownValues": [
                    "owner",
                    "visitor"
                  ],
                  "type": "string"
                },
                "updatedAt": {
                  "description": "When this last changed. Absent when the domain is using the default.",
                  "format": "datetime",
                  "type": "string"
                },
                "visitorCapBytes": {
                  "description": "The most any one visitor can 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
}