space.highport.manage.connectSpace

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.

Details · procedure
Kindprocedure
Authoritymanage.highport.space
Indexed
cid bafyreifjn5zom4yus3ffvptgnaqyo66dzzoef7uufgwtatxh5teclgdlae

Checks

Valid
  • unlimited-string defs.main.input.schema.properties.delegationTokenNo maxLength, maxGraphemes or format limits this string.
JSONDownload
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "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.",
      "errors": [
        {
          "description": "Only the space's authority may connect it.",
          "name": "NotSpaceAuthority"
        },
        {
          "description": "The delegation token was not issued by the caller.",
          "name": "GrantIssuerMismatch"
        },
        {
          "description": "The delegation token has expired.",
          "name": "GrantExpired"
        },
        {
          "description": "The space host refused the exchange.",
          "name": "GrantRefused"
        },
        {
          "description": "The space does not allow bard access yet. The space is recorded and will sync once it does.",
          "name": "AppNotAllowed"
        },
        {
          "description": "This identity has reached its limit of connected spaces.",
          "name": "SpaceQuotaExceeded"
        },
        {
          "description": "Space support is disabled on this deployment.",
          "name": "SpacesDisabled"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "delegationToken": {
              "description": "A delegation token the authority minted for this space. Used once and never stored.",
              "type": "string"
            },
            "space": {
              "description": "The space, at://{authority}/space/space.highport.sites.space/{skey}.",
              "format": "at-uri",
              "type": "string"
            }
          },
          "required": [
            "space",
            "delegationToken"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "ref": "space.highport.defs#spaceView",
          "type": "ref"
        }
      },
      "type": "procedure"
    }
  },
  "id": "space.highport.manage.connectSpace",
  "lexicon": 1
}