full diff

space.highport.manage.setDomainBilling

From
bafyreied6p5tt7fbczv7ofkrqiplgunxeeims7xz5ta2fwc3wshmi7tnsi indexed 2026-09-04 22:52 UTC View this version
To
bafyreiciak4lqf2pdkgflzecmdbu7p4d3uaw6ql2wc7cv5oruzktbqsayy indexed 2026-09-17 17:51 UTC View this version

Compatibility

backward compatible No changes detected.

Changes

11{
22 "$type": "com.atproto.lexicon.schema",
33 "defs": {
44 "main": {
5 "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.",
5 "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.",
66 "errors": [
77 {
8 "description": "Not a syntactically valid, non-reserved, public-suffix-safe domain. Distinct from DomainNotFound: the string is not a hostname at all.",
8 "description": "Not a valid, non-reserved, public-suffix-safe domain. Unlike DomainNotFound, the input is not a hostname at all.",
99 "name": "InvalidDomain"
1010 },
1111 {
12 "description": "No such domain, or it is not registered to the calling identity.",
12 "description": "No such domain, or it does not belong to the caller.",
1313 "name": "DomainNotFound"
1414 },
1515 {
16 "description": "payerPolicy is not one of owner or visitor.",
16 "description": "payerPolicy must be owner or visitor.",
1717 "name": "InvalidRequest"
1818 }
1919 ],
2020 "input": {
2121 "encoding": "application/json",
2222 "schema": {
2323 "properties": {
2424 "domain": {
25 "description": "The registered hostname. Must be registered to the calling identity.",
25 "description": "The registered hostname. Must belong to the caller.",
2626 "maxLength": 253,
2727 "type": "string"
2828 },
2929 "fallbackToOwner": {
3030 "default": true,
31 "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.",
31 "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.",
3232 "type": "boolean"
3333 },
3434 "ownerBudgetBytes": {
35 "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.",
35 "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.",
3636 "minimum": 0,
3737 "type": "integer"
3838 },
3939 "payerPolicy": {
40 "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.",
40 "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.",
4141 "knownValues": [
4242 "owner",
4343 "visitor"
4444 ],
4545 "type": "string"
4646 },
4747 "visitorCapBytes": {
48 "description": "A ceiling on what any single visitor may spend here per period. Absent means no ceiling beyond the one the visitor themselves set.",
48 "description": "The most any one visitor can spend here per period. Absent means only the visitor's own cap applies.",
4949 "minimum": 0,
5050 "type": "integer"
5151 }
5252 },
5353 "required": [
5454 "domain",
5555 "payerPolicy"
5656 ],
5757 "type": "object"
5858 }
5959 },
6060 "output": {
6161 "encoding": "application/json",
6262 "schema": {
6363 "properties": {
6464 "approvalsRevoked": {
65 "description": "How many visitor approvals the policy change invalidated.",
65 "description": "How many visitor approvals the policy change revoked.",
6666 "type": "integer"
6767 },
6868 "billing": {
69 "description": "Whose allowance a domain's traffic draws on.",
69 "description": "Whose allowance a domain's traffic uses.",
7070 "properties": {
7171 "domain": {
7272 "description": "The domain.",
7373 "type": "string"
7474 },
7575 "fallbackToOwner": {
76 "description": "Under the visitor policy, whether a visitor with nothing left falls back to the owner rather than being refused.",
76 "description": "Under the visitor policy: whether a visitor who has run out falls back to the owner instead of being refused.",
7777 "type": "boolean"
7878 },
7979 "ownerBudgetBytes": {
80 "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.",
80 "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.",
8181 "minimum": 0,
8282 "type": "integer"
8383 },
8484 "payerPolicy": {
8585 "description": "owner or visitor.",
8686 "knownValues": [
8787 "owner",
8888 "visitor"
8989 ],
9090 "type": "string"
9191 },
9292 "updatedAt": {
93 "description": "When it last changed. Absent when the domain has no arrangement recorded and is reporting the default.",
93 "description": "When this last changed. Absent when the domain is using the default.",
9494 "format": "datetime",
9595 "type": "string"
9696 },
9797 "visitorCapBytes": {
98 "description": "A ceiling on what any single visitor may spend here per period.",
98 "description": "The most any one visitor can spend here per period.",
9999 "type": "integer"
100100 }
101101 },
102102 "required": [
103103 "domain",
104104 "payerPolicy",
105105 "fallbackToOwner"
106106 ],
107107 "type": "object"
108108 }
109109 },
110110 "required": [
111111 "billing"
112112 ],
113113 "type": "object"
114114 }
115115 },
116116 "type": "procedure"
117117 }
118118 },
119119 "id": "space.highport.manage.setDomainBilling",
120120 "lexicon": 1
121121}

Compare other versions