fyi.opensocial.shareTab

lexicons.opensocial.fyi

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Share a tab you can see as a template, for whoever it's shared with to add: its page, its methods and the kinds of record it makes up, never anything written in it. Shared with the group, it's kept in the group's members space, for members to add to their channels. Shared with everyone as the group, it's published in the group's own repo, by whoever may publish for the group, for anyone with its link to add to their own group. Sharing the same tab again to the same place puts out a new version of the same template. To share it with everyone as yourself, see getTabBundle.",
      "errors": [
        {
          "name": "InvalidTab"
        },
        {
          "name": "NotFound"
        },
        {
          "name": "Forbidden"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "audience": {
              "description": "Who it's shared with: group, the group's members alone; everyone-as-group, anyone, from the group.",
              "knownValues": [
                "group",
                "everyone-as-group"
              ],
              "maxLength": 32,
              "type": "string"
            },
            "changes": {
              "description": "What's new since it was last shared.",
              "maxGraphemes": 300,
              "maxLength": 3000,
              "type": "string"
            },
            "description": {
              "description": "One line saying what it is.",
              "maxGraphemes": 300,
              "maxLength": 3000,
              "type": "string"
            },
            "group": {
              "format": "did",
              "type": "string"
            },
            "name": {
              "description": "What it's called, where it's offered.",
              "maxGraphemes": 64,
              "maxLength": 640,
              "type": "string"
            },
            "tab": {
              "description": "The tab's namespace.",
              "maxLength": 13,
              "type": "string"
            }
          },
          "required": [
            "group",
            "tab",
            "name",
            "description",
            "audience"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "number": {
              "description": "Which version it is.",
              "minimum": 1,
              "type": "integer"
            },
            "uri": {
              "description": "The template, its fyi.opensocial.template: in the members space, or the group's repo.",
              "format": "at-uri",
              "type": "string"
            },
            "version": {
              "description": "The version just put out, its fyi.opensocial.templateVersion.",
              "ref": "com.atproto.repo.strongRef",
              "type": "ref"
            }
          },
          "required": [
            "uri",
            "version",
            "number"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "id": "fyi.opensocial.shareTab",
  "lexicon": 1
}

Validate Record

Validate a record against fyi.opensocial.shareTab

Validation Options
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:2gqnilpksz2e7faj3bwvo6qc
CID
bafyreibekt3m4ppxt73arylewcevvinlvkewphyq245nwfwbpkpplucq6u
Indexed At
2026-10-17 02:20 UTC
AT-URI
at://did:plc:2gqnilpksz2e7faj3bwvo6qc/com.atproto.lexicon.schema/fyi.opensocial.shareTab

Similar Lexicons

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Where a tab you can see is shared as a template: within the group, with everyone from the group, and with everyone from you; each with its versions, and whether you may take one back.

  • A tab you can see, as a template shared from it has it, for sharing it with everyone as yourself: its page, its methods and the kinds of record it makes up, the tab's namespace in them made the placeholder, and what a t…

  • The templates shared within the group, each at its latest version: for its members alone.

  • A template for a tab for a group's site, published by whoever made it, as it's listed: its name, what it's for, its icon, and its latest version, a fyi.opensocial.templateVersion. A site names it by URI; an agent instal…

  • A template shared with everyone, for its own page: what it's called, who made it, what a tab of it does at its latest version, and every version. For anyone; never one shared within a group.

Lexicon Garden

@