space.highport.manage.connectSpace
Schema Diff
+6 -6
Compatibility Analysis
Backward Compatible
No changes detected.
1
1
{
2
2
"id": "space.highport.manage.connectSpace",
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
"description": "The space, at://{authority}/space/space.highport.sites.space/{skey}."
18
18
},
19
19
"delegationToken": {
20
20
"type": "string",
21
-
"description": "A delegation token minted by the authority for this space; spent immediately and never stored."
21
+
"description": "A delegation token the authority minted for this space. Used once and never stored."
22
22
}
23
23
}
24
24
},
25
25
"encoding": "application/json"
26
26
},
27
27
"errors": [
28
28
{
29
29
"name": "NotSpaceAuthority",
30
30
"description": "Only the space's authority may connect it."
31
31
},
32
32
{
33
33
"name": "GrantIssuerMismatch",
34
-
"description": "The delegation token's issuer is not the calling identity."
34
+
"description": "The delegation token was not issued by the caller."
35
35
},
36
36
{
37
37
"name": "GrantExpired",
38
-
"description": "The delegation token is past its lifetime."
38
+
"description": "The delegation token has expired."
39
39
},
40
40
{
41
41
"name": "GrantRefused",
42
42
"description": "The space host refused the exchange."
43
43
},
44
44
{
45
45
"name": "AppNotAllowed",
46
-
"description": "The space's app access does not admit bard; the space is recorded and will sync once it does."
46
+
"description": "The space does not allow bard access yet. The space is recorded and will sync once it does."
47
47
},
48
48
{
49
49
"name": "SpaceQuotaExceeded",
50
-
"description": "This identity has reached its connected-space limit."
50
+
"description": "This identity has reached its limit of connected spaces."
51
51
},
52
52
{
53
53
"name": "SpacesDisabled",
54
54
"description": "Space support is disabled on this deployment."
55
55
}
56
56
],
57
57
"output": {
58
58
"schema": {
59
59
"ref": "space.highport.defs#spaceView",
60
60
"type": "ref"
61
61
},
62
62
"encoding": "application/json"
63
63
},
64
-
"description": "Connect a space so bard reads and publishes the authority's site and tile records from it. Authority only, and the delegation token must be the authority's own. Bard exchanges the token for a credential under its own key, registers for notifications, bootstraps the authority's repo, and records the space. Idempotent."
64
+
"description": "Connect a space so bard can read and publish the authority's site and tile records from it. Only the authority can call this, with a delegation token it issued. Bard trades the token for a credential, registers for notifications, and pulls the authority's repo. Safe to repeat."
65
65
}
66
66
},
67
67
"$type": "com.atproto.lexicon.schema",
68
68
"lexicon": 1
69
69
}