space.highport.manage.connectSpace

lexicons.highport.space

Documentation

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.

main procedure

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.

Input

Encodingapplication/json
delegationToken string Required

A delegation token the authority minted for this space. Used once and never stored.

space stringat-uri Required

The space, at://{authority}/space/space.highport.sites.space/{skey}.

Output

Encodingapplication/json
Schemaspace.highport.defs#spaceView

Errors

NotSpaceAuthority Only the space's authority may connect it.
GrantIssuerMismatch The delegation token was not issued by the caller.
GrantExpired The delegation token has expired.
GrantRefused The space host refused the exchange.
AppNotAllowed The space does not allow bard access yet. The space is recorded and will sync once it does.
SpaceQuotaExceeded This identity has reached its limit of connected spaces.
SpacesDisabled Space support is disabled on this deployment.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "space",
        "delegationToken"
      ],
      "properties": {
        "space": {
          "type": "string",
          "format": "at-uri",
          "description": "The space, at://{authority}/space/space.highport.sites.space/{skey}."
        },
        "delegationToken": {
          "type": "string",
          "description": "A delegation token the authority minted for this space. Used once and never stored."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "NotSpaceAuthority",
      "description": "Only the space's authority may connect it."
    },
    {
      "name": "GrantIssuerMismatch",
      "description": "The delegation token was not issued by the caller."
    },
    {
      "name": "GrantExpired",
      "description": "The delegation token has expired."
    },
    {
      "name": "GrantRefused",
      "description": "The space host refused the exchange."
    },
    {
      "name": "AppNotAllowed",
      "description": "The space does not allow bard access yet. The space is recorded and will sync once it does."
    },
    {
      "name": "SpaceQuotaExceeded",
      "description": "This identity has reached its limit of connected spaces."
    },
    {
      "name": "SpacesDisabled",
      "description": "Space support is disabled on this deployment."
    }
  ],
  "output": {
    "schema": {
      "ref": "space.highport.defs#spaceView",
      "type": "ref"
    },
    "encoding": "application/json"
  },
  "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."
}

Lexicon Garden

@