space.highport.manage.grantSpaceAccess
Schema Diff
+9 -9
Compatibility Analysis
Backward Compatible
No changes detected.
1
1
{
2
2
"$type": "com.atproto.lexicon.schema",
3
3
"defs": {
4
4
"main": {
5
-
"description": "Hand bard a delegation token so it can keep reading a space. Any member may grant; the calling identity must be the token's issuer. Bard exchanges it under its own key, stores the credential, renews the notification registration when due, drains a queued receipt, and runs a head check if the space had lapsed.",
5
+
"description": "Give bard a delegation token so it can keep reading a space. Any member can call this with a token they issued. Bard trades it for a credential, renews its notification registration when due, and catches up on anything it missed.",
6
6
"errors": [
7
7
{
8
-
"description": "Bard is not connected to that space; call connectSpace first.",
8
+
"description": "Bard is not connected to that space. Call connectSpace first.",
9
9
"name": "SpaceNotFound"
10
10
},
11
11
{
12
-
"description": "The delegation token's issuer is not the calling identity.",
12
+
"description": "The delegation token was not issued by the caller.",
13
13
"name": "GrantIssuerMismatch"
14
14
},
15
15
{
16
-
"description": "The delegation token is past its lifetime.",
16
+
"description": "The delegation token has expired.",
17
17
"name": "GrantExpired"
18
18
},
19
19
{
20
20
"description": "The space host refused the exchange.",
21
21
"name": "GrantRefused"
22
22
},
23
23
{
24
-
"description": "The space's app access does not admit bard.",
24
+
"description": "The space does not allow bard access.",
25
25
"name": "AppNotAllowed"
26
26
},
27
27
{
28
28
"description": "Space support is disabled on this deployment.",
29
29
"name": "SpacesDisabled"
30
30
}
31
31
],
32
32
"input": {
33
33
"encoding": "application/json",
34
34
"schema": {
35
35
"properties": {
36
36
"delegationToken": {
37
-
"description": "A delegation token minted by the calling identity for this space; spent immediately and never stored.",
37
+
"description": "A delegation token the caller minted for this space. Used once and never stored.",
38
38
"type": "string"
39
39
},
40
40
"space": {
41
41
"format": "at-uri",
42
42
"type": "string"
43
43
}
44
44
},
45
45
"required": [
46
46
"space",
47
47
"delegationToken"
48
48
],
49
49
"type": "object"
50
50
}
51
51
},
52
52
"output": {
53
53
"encoding": "application/json",
54
54
"schema": {
55
55
"properties": {
56
56
"accessExpiresAt": {
57
-
"description": "When the credential bard now holds expires.",
57
+
"description": "When bard's new credential expires.",
58
58
"format": "datetime",
59
59
"type": "string"
60
60
},
61
61
"drained": {
62
-
"description": "Queued notification receipts turned into sync jobs by this grant.",
62
+
"description": "Queued notifications this grant turned into sync jobs.",
63
63
"type": "integer"
64
64
},
65
65
"registrationExpiresAt": {
66
-
"description": "When bard's notification registration at the space host expires.",
66
+
"description": "When bard's notification registration with the space host expires.",
67
67
"format": "datetime",
68
68
"type": "string"
69
69
}
70
70
},
71
71
"required": [
72
72
"accessExpiresAt",
73
73
"drained"
74
74
],
75
75
"type": "object"
76
76
}
77
77
},
78
78
"type": "procedure"
79
79
}
80
80
},
81
81
"id": "space.highport.manage.grantSpaceAccess",
82
82
"lexicon": 1
83
83
}