fyi.opensocial.getSiteDraft

The caller's draft of the group's site, if they have one, and whether the site's last publish can be undone. Only for whoever may change the site.

Details · query
Kindquery
Authorityopensocial.fyi
Indexed

Showing version bafyreibjxud5zuraib7emp4bhtyru3xrzquoysjyd73a66g5b3kxwffsbe. Show the latest

Query

query · GET

Parameters

query string

group

requiredstring · did

Output

application/json
Reference

making

boolean

Whether the host is making the caller a draft now: a new group's front page.

undo

ref
Reference

Errors

Forbidden

No description in schema.

#change

object

One thing a draft changes, as a member would name it, and where it is.

Properties

channel

string

The channel it's in, by its address.

how

string

Added or removed; otherwise changed.

  • knownValues: added | removed

name

requiredstring

As a member would say it: the tab's name, "the colours and fonts".

path

string

A public page's path.

tab

string

The tab, by its address.

what

requiredstring

A tab (its page or settings), a tab's public page, a channel, the site design around the public pages, the colours and fonts, the public menu, or the group's own: its name, about, rules, pictures.

  • knownValues: tab | public | channel | design | look | menu | group

#draft

object

Properties

avatar

string · uri

The group's picture, as the draft changes it.

banner

string · uri

Its banner, as the draft changes it.

by

requiredstring

Who made the last change to it: an AI app's name.

changed

array

What it changes from the live site, each thing once.

itemsref
Reference

createdAt

string · datetime

What the group says about itself, as the draft changes it.

How people join, as the draft changes it.

name

string

The group's name, as the draft changes it.

note

string

What the AI app that made it says it does, in its own words.

  • maxLength: 3000
  • maxGraphemes: 300

rules

array

The group's rules, as the draft has them.

itemsref
Reference

updatedAt

requiredstring · datetime

uri

requiredstring · at-uri

The draft's site record, in the members space.

#rule

object

Properties

text

string

title

requiredstring

#undo

object

Properties

mine

requiredboolean

publishedAt

requiredstring · datetime

Similar lexicons

semantic match

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

  • A member's draft of the group's site, keyed by the member's DID: what an AI app connected as them changed, kept apart from the live site (fyi.opensocial.site) until they publish it. Shaped as the site is.

  • Every public page of the group's site as the caller's draft would publish it.

  • The page the caller's assistant left for one of the site's tabs (which needs group.configure), if any, and the caller's assistants connected to the group. Only the caller's own: nobody sees another member's drafts.

  • A group's site, in its members space: channels of tabs, shown one at a time, each a whole HTML document drawn in a sandboxed frame. Authored by the group DID; written through putSite by whoever holds group.configure. Anyone else is handed only its public part, by the host. A group without one is shown the starter.

  • The drafts your assistant left for you in the group's tabs, waiting for you to add or let go: each with the space it goes in, added as you, or for its tab's page to make into what it keeps (page).