fyi.opensocial
170
Narrow ›
-
fyi.opensocial.acceptance
record
The member's side of membership, written by the member into the members space. Gates appearing in the roster, not access.
-
fyi.opensocial.access
record
Who can access this space, in every space under the group. Grants apply only to this space. Members whose roles grant read may obtain space credentials and write their own records here. The group authority issues space credentials according to this record and nothing else.
-
fyi.opensocial.activateGroup
procedure
Switch a deactivated group back on. Allowed to anyone who held group.configure when it was switched off.
-
fyi.opensocial.actor.link
record
not from the namespace authority
A link shown on a member's profile in one group, beside their fyi.opensocial.actor.profile in the group's members space. The profile's links field sets which are shown, and in what order. Its fields are app.bsky.actor.link's.
-
fyi.opensocial.actor.profile
record
not from the namespace authority
How a member shows in one group: written by the member, in their own repo in the group's members space, so only the group's members read it. Shown in that group instead of their profile elsewhere. Its fields are app.bsky.actor.profile's.
-
fyi.opensocial.addRecoveryKey
procedure
Add a steward's recovery key to the group's did:plc, ahead of this host's own key. Only the public did:key is sent; the private half stays with the steward. Requires group.configure.
-
fyi.opensocial.admitMember
procedure
Approve a join request, giving the requester their roles. Requires admit. denyJoinRequest declines one.
-
fyi.opensocial.applyLabel
procedure
Write a label record into the subject's space. Requires label, or takedown for !hide and !takedown.
-
fyi.opensocial.approveAssistantRequest
procedure
Connect an assistant to the group as the caller: it may read what the caller can, and leave pages for the caller to look at: their own, and, with group.configure, the site's tabs'. Requires membership.
-
fyi.opensocial.approveAuthorization
procedure
Approve an app's pending request to sign in as a group. The app gets what the caller's roles in the group allow and nothing more, and every token it obtains is recorded as the caller's. Returns the URL to send the browser back to the app with.
-
fyi.opensocial.assignRoles
procedure
Set a member's full role set. Requires role.assign; every role added or removed must be in the caller's assignable set.
-
fyi.opensocial.basePermissions
permission-set
-
fyi.opensocial.cancelAccountMove
procedure
Stop moving the account the caller signed in to move: its tokens are given back to its server and forgotten here, and a copy of it not yet finished is discarded.
-
fyi.opensocial.cancelJoinRequest
procedure
Withdraw a pending join request.
-
fyi.opensocial.channel
space
A channel of a group's site kept for chosen people: only they can see it, read what's in it, or change it, whoever runs the group included. The group keeps it, its host on their behalf; it holds the channel itself, its name, tabs and pages of their own, as the group's one record.
-
fyi.opensocial.channel.about
record
not from the namespace authority
A channel for chosen people, as its space holds it: its address, its name, its tabs in order as a group's site has them, and the files of their own those tabs show. Who it's for is its space's access.
-
fyi.opensocial.checkAddress
query
Whether an address under this host's domain is free for a new group: no account's handle here, nor kept by a group as its address after it took a handle of its own. Anyone may ask, as anyone may resolve a handle.
-
fyi.opensocial.checkGroupHandle
query
Whether a domain is ready to be the group's handle: what its _atproto DNS record, or its /.well-known/atproto-did, names now. Changes nothing. Requires group.configure.
-
fyi.opensocial.checkImport
query
What moving an account here would make of it, before anything moves (importAccount moves it so): its handle here, whether that's the one it has, and its address, this host's own name for it. A handle on a domain of the account's own that still names it comes along; one its old server gives out becomes the address. `refused` says why it can't have that address, as importAccount would. While the caller's own move of it is pending, `recommendedCreds` says again what the operation should name, as im
-
fyi.opensocial.completeImport
procedure
Finish moving an account here: send the PLC operation its old server signed, which must give it to this host as importAccount said, switch it on and tell the network, and make the group's spaces with the caller as its admin. Only for whoever started the move.
-
fyi.opensocial.configure
permission-set
For group-DID sessions.
-
fyi.opensocial.conversation
space
A conversation between people, hosted by whoever started it, not by a group. Its member list is everyone in it; each person's messages are in their own repo in the space. The starter's about record says who's in it.
-
fyi.opensocial.conversation.about
record
not from the namespace authority
Who's in a conversation, as its starter keeps it, for the others to see: the member list itself is the starter's server's to read.
-
fyi.opensocial.conversation.message
record
not from the namespace authority
Something said in a conversation, in its author's own repo in the conversation's space.
-
fyi.opensocial.conversation.pointer
record
not from the namespace authority
Left in someone's inbox by whoever put them in a conversation, keyed by the conversation's key: how they find it.
-
fyi.opensocial.conversation.state
record
not from the namespace authority
Where you are in a conversation, kept in your own inbox where only you read it, keyed by the conversation's key: how far you've read, and whether it's muted or left. Never shown to the others.
-
fyi.opensocial.createAppPassword
procedure
Make an app password for the group: what an app that signs in with a handle and a password, such as the Bluesky app, signs in to the group with (com.atproto.server.createSession). It stays the caller's: it stops working once they could no longer make it, and its sessions are listed as theirs among the group's connected apps. Its sessions may use the group's public repo, its blobs and other services, never its spaces, nor get service tokens for the account's own methods or this host's. Requires a
-
fyi.opensocial.createGroup
procedure
Host-level: create a new group on this host. Authenticated as the founder (service auth from their PDS). The founder and any listed stewards become its first admins. Mints the group DID, creates the meta and members spaces, writes the bootstrap records and, for a discoverable group, a declaration. Modality spaces are left to the apps that use them (createSpace).
-
fyi.opensocial.createInvite
procedure
Write an invite into someone's own invites space. Requires invite.
-
fyi.opensocial.createPeopleSpace
procedure
Make a new place of the group's for a channel kept for chosen people — a chat, say, for a tab about it — readable and written in by that channel's people alone, and kept so as they change. Anyone in the channel may.
-
fyi.opensocial.createReport
procedure
Report an account or record in a group, opening or reopening it in the moderation queue. Uses service auth from the caller, who must be able to read the subject's space.
-
fyi.opensocial.createSpace
procedure
Create a space under the group with its access record and, unless index is false, an index entry. Requires space.create.
-
fyi.opensocial.deactivateGroup
procedure
Switch the group off: its account is deactivated on this host, so nothing can read its spaces or write as it. Reversible with activateGroup. Requires group.configure. The host remembers who held group.configure at this moment, because while the group is off its membership cannot be read.
-
fyi.opensocial.decideTabOffer
procedure
Decide on a tab offered to the site, for whoever may change it: accept puts it in one of the site's channels as it is, with everything kept in it, now read by whoever that channel is for; decline leaves it where it was.
-
fyi.opensocial.declaration
record
Marks a DID as a group. Lives in the public repo. Points at the meta space. Discovery only.
-
fyi.opensocial.declineAssistantRequest
procedure
Turn down an assistant's request to connect to the group.
-
fyi.opensocial.declineAuthorization
procedure
Decline an app's pending request to sign in as a group. Returns the URL to send the browser back to the app with, carrying access_denied.
-
fyi.opensocial.declineInvite
procedure
Turn down the group's invite to the caller: it goes from the group's list and the caller's inbox. The group may invite them again.
-
fyi.opensocial.defs
defs
Contents of an access record.
-
fyi.opensocial.deleteDraft
procedure
Let a draft your assistant left go: added, or not wanted.
-
fyi.opensocial.deleteGroup
procedure
Delete the group: its account, its repo and its spaces on this host, and the host's own state about it. Irreversible. Requires group.configure, or, for a deactivated group, having held it when the group was switched off. Records members wrote into its spaces live on their own PDSes and are not touched. If no steward holds a recovery key, the group's did:plc is tombstoned too, since nobody could ever use it again; with one, the DID is left for its holders.
-
fyi.opensocial.deletePageDraft
procedure
Drop the page the caller's assistant left for a tab: once it is published or saved, or not wanted.
-
fyi.opensocial.deletePeopleChannel
procedure
Delete a channel kept for chosen people, for everyone in it: anyone in it may. What its tabs kept goes with it.
-
fyi.opensocial.deleteRole
procedure
Remove a role. Requires group.configure. Fails if any membership still holds it.
-
fyi.opensocial.deleteRule
procedure
Remove a rule. Requires group.configure.
-
fyi.opensocial.deleteSpace
procedure
Delete a group space and its index entry. Requires space.delete.
-
fyi.opensocial.denyJoinRequest
procedure
Deny a pending join request. Requires admit. The requester sees it as no request at all, and may ask again.
-
fyi.opensocial.describePush
query
How this host sends alerts to people's devices (Web Push): the key a browser subscribes with, and, to someone signed in, how many of their devices it alerts.
-
fyi.opensocial.discardSiteDraft
procedure
Let the caller's draft go: the live site is as it was.
-
fyi.opensocial.draftFrontPage
procedure
Start making a new group's front page and the layout around its public pages, in its look, into the caller's draft: getSiteDraft says it's being made, then has the draft. Nothing if the caller has a draft already or the site has a front page or layout of its own.
120 more under fyi.opensocial ›