space.highport.manage.purge
Schema Diff
+2 -2
Compatibility Analysis
Backward Compatible
No changes detected.
1
1
{
2
2
"id": "space.highport.manage.purge",
3
3
"defs": {
4
4
"main": {
5
5
"type": "procedure",
6
6
"input": {
7
7
"schema": {
8
8
"type": "object",
9
9
"required": [
10
10
"domain"
11
11
],
12
12
"properties": {
13
13
"paths": {
14
14
"type": "array",
15
15
"items": {
16
16
"type": "string"
17
17
},
18
-
"description": "Accepted and ignored: invalidation is whole-domain."
18
+
"description": "Accepted but ignored. A purge always covers the whole domain."
19
19
},
20
20
"domain": {
21
21
"type": "string",
22
22
"maxLength": 253,
23
23
"description": "The registered hostname."
24
24
}
25
25
}
26
26
},
27
27
"encoding": "application/json"
28
28
},
29
29
"errors": [
30
30
{
31
31
"name": "DomainNotFound",
32
32
"description": "No registration for that domain belongs to the caller."
33
33
},
34
34
{
35
35
"name": "RateLimitExceeded",
36
36
"description": "Too many purge requests."
37
37
}
38
38
],
39
39
"output": {
40
40
"schema": {
41
41
"type": "object",
42
42
"required": [
43
43
"purged"
44
44
],
45
45
"properties": {
46
46
"purged": {
47
47
"type": "boolean"
48
48
}
49
49
}
50
50
},
51
51
"encoding": "application/json"
52
52
},
53
-
"description": "Drop the domain's cached pointer and snapshot from every origin replica by broadcasting an invalidation. There is no shared HTTP cache to purge; this is an operator escape hatch for a suspected stale in-process cache, not part of the publish path. Rate-limited."
53
+
"description": "Clear the domain's cached pointer and snapshot on every origin replica. There is no shared HTTP cache, so this is only an escape hatch for a suspected stale in-process cache; publishing never needs it. Rate-limited."
54
54
}
55
55
},
56
56
"$type": "com.atproto.lexicon.schema",
57
57
"lexicon": 1
58
58
}