space.highport.manage.grantSpaceAccess
Schema Diff
+9 -9
Compatibility Analysis
Backward Compatible
No changes detected.
1
1
{
2
2
"id": "space.highport.manage.grantSpaceAccess",
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
"space",
11
11
"delegationToken"
12
12
],
13
13
"properties": {
14
14
"space": {
15
15
"type": "string",
16
16
"format": "at-uri"
17
17
},
18
18
"delegationToken": {
19
19
"type": "string",
20
-
"description": "A delegation token minted by the calling identity for this space; spent immediately and never stored."
20
+
"description": "A delegation token the caller minted for this space. Used once and never stored."
21
21
}
22
22
}
23
23
},
24
24
"encoding": "application/json"
25
25
},
26
26
"errors": [
27
27
{
28
28
"name": "SpaceNotFound",
29
-
"description": "Bard is not connected to that space; call connectSpace first."
29
+
"description": "Bard is not connected to that space. Call connectSpace first."
30
30
},
31
31
{
32
32
"name": "GrantIssuerMismatch",
33
-
"description": "The delegation token's issuer is not the calling identity."
33
+
"description": "The delegation token was not issued by the caller."
34
34
},
35
35
{
36
36
"name": "GrantExpired",
37
-
"description": "The delegation token is past its lifetime."
37
+
"description": "The delegation token has expired."
38
38
},
39
39
{
40
40
"name": "GrantRefused",
41
41
"description": "The space host refused the exchange."
42
42
},
43
43
{
44
44
"name": "AppNotAllowed",
45
-
"description": "The space's app access does not admit bard."
45
+
"description": "The space does not allow bard access."
46
46
},
47
47
{
48
48
"name": "SpacesDisabled",
49
49
"description": "Space support is disabled on this deployment."
50
50
}
51
51
],
52
52
"output": {
53
53
"schema": {
54
54
"type": "object",
55
55
"required": [
56
56
"accessExpiresAt",
57
57
"drained"
58
58
],
59
59
"properties": {
60
60
"drained": {
61
61
"type": "integer",
62
-
"description": "Queued notification receipts turned into sync jobs by this grant."
62
+
"description": "Queued notifications this grant turned into sync jobs."
63
63
},
64
64
"accessExpiresAt": {
65
65
"type": "string",
66
66
"format": "datetime",
67
-
"description": "When the credential bard now holds expires."
67
+
"description": "When bard's new credential expires."
68
68
},
69
69
"registrationExpiresAt": {
70
70
"type": "string",
71
71
"format": "datetime",
72
-
"description": "When bard's notification registration at the space host expires."
72
+
"description": "When bard's notification registration with the space host expires."
73
73
}
74
74
}
75
75
},
76
76
"encoding": "application/json"
77
77
},
78
-
"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."
78
+
"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."
79
79
}
80
80
},
81
81
"$type": "com.atproto.lexicon.schema",
82
82
"lexicon": 1
83
83
}