social.colibri.beta.community.getHosting
Describes where a community's account lives and whether the AppView can still act for it. Only administrators of the community can read it.
Details · query
| Kind | query |
|---|---|
| Authority | community.beta.colibri.social |
| Indexed |
Query
query · GETParameters
query stringThe community.
Output
application/jsonWhere the community's account lives.
Errors
AuthRequired
The request is missing, malformed, or unverifiable service auth.
Forbidden
The requesting user lacks permission for this community.
CommunityNotFound
No community exists at that identifier.
#hostingView
objectWhere a community's account lives and whether the AppView can act for it.
Properties
The account's handle, or its DID when it has none.
connectedAt
string · datetimeWhen the AppView was last connected to the account.
connectedBy
string · didThe user who signed in as the account, for kind own.
handOverExpiresAt
string · datetimeWhen the password from handOverHost stops working, while a hand-over is active.
colibri when the account lives on this AppView's server and the AppView holds its password. own when the account belongs to the community's owner and the AppView acts through a sign-in.
knownValues: colibri | own
Whether the AppView lost access and needs the owner to sign in again. New writes fail until then.
needsSignInSince
string · datetimeWhen the AppView lost access.
The server the account lives on, as the AppView last reached it.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Starts a sign-in as a community host account. The requesting user opens the returned URL, signs in as that account on its own server and allows the AppView to act for it. The AppView then adopts the account as a new community, or reconnects an existing community after its sign-in lapsed or its account moved. Poll getHostAuthorization with the returned request to learn the outcome.
-
Gets a community by DID or handle.
-
Reports the outcome of a sign-in started with authorizeHost. Only the user who started it can read it.
-
Get detailed information about a community. Authentication optional; viewer state will be included if authenticated.
-
Gives an administrator access to a community account that lives on this AppView's server, so they can move it to another server. The AppView sets the given email on the account, so codes the server sends reach the administrator, and returns a new password once. The password works for 60 minutes. If the account has not moved by then, the AppView replaces it and signs out every session.