Lexicon Garden

fyi.opensocial.shareTab

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.

Repository @lexicons.opensocial.fyi did:plc:2gqnilpksz2e7faj3bwvo6qc namespace authority
Details · procedure
Kindprocedure
Authorityopensocial.fyi
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

audience

requiredstring

Who it's shared with: group, the group's members alone; everyone-as-group, anyone, from the group.

  • maxLength: 32
  • knownValues: group | everyone-as-group

changes

string

What's new since it was last shared.

  • maxLength: 3000
  • maxGraphemes: 300

description

requiredstring

One line saying what it is.

  • maxLength: 3000
  • maxGraphemes: 300

group

requiredstring · did

name

requiredstring

What it's called, where it's offered.

  • maxLength: 640
  • maxGraphemes: 64

tab

requiredstring

The tab's namespace.

  • maxLength: 13

Output

application/json

number

requiredinteger

Which version it is.

  • minimum: 1

uri

requiredstring · at-uri

The template, its fyi.opensocial.template: in the members space, or the group's repo.

version

requiredref

The version just put out, its fyi.opensocial.templateVersion.

Reference

Errors

InvalidTab

No description in schema.

NotFound

No description in schema.

Forbidden

No description in schema.

Similar lexicons

semantic match

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

  • fyi.opensocial.listTabShares

    query

    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.

  • fyi.opensocial.getTabBundle

    query

    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 tab of it does. Its records are written in your own repo by you: a fyi.opensocial.templateVersion, each file a blob, and the fyi.opensocial.template listing it, at the record key given. Refused as shareTab refuses, and a new version whose kinds of record change in a way records alr

  • fyi.opensocial.listTemplates

    query

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

  • fyi.opensocial.template

    record

    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 installs it as a skill. Keyed by the template's name.

  • fyi.opensocial.templateVersion

    record

    One version of a published template, as it was put out: never changed, so a tab that names it gets what was chosen. Its files are the template itself, as a folder of it has them: `template.html` (the page, drawn in a sandboxed frame with the site kit in front of it), `SKILL.md` (how to use it, for an agent), `outside.js` and `outside.html` (its public page, if its tabs can have one), `methods/<name>.js` with `lexicons/<name>.json` (the methods it brings, each a query every tab made from it answe