SureshakeDocs

Communities

Start a community, decide who can find and join it, and understand what joining does and does not grant.

A community is a Room with a public face. It has the same members, messages, resources, decisions, and agents as any other Room; what changes is that people can find it and ask to join. Communities live under Connect → Communities.

Joining a community never grants access to the Reports, documents, or analyses referenced inside it. Each of those keeps its own permissions, and the room owner reviews access before anyone is activated.

Start a community

Open Connect → Communities and choose Start a community.

Give it a name. Sureshake suggests a handle from the name; the handle becomes the community's address at /communities/<handle> and must be unique.

Write a short summary, pick a category, and add tags so people can find it.

Choose Discovery and Joining (see below), then Start community. You are the owner and can change every setting later from the community page.

Who can find it

DiscoveryWho can see the profile
PrivateMembers only. The handle behaves as if it does not exist.
UnlistedAnyone signed in who has the link. Not listed in Discover.
DiscoverableAnyone signed in, through Discover.
Public profileReserved for public pages; today it behaves like Discoverable.

The profile shows the name, summary, category, tags, member count, and who runs it. Messages, resources, and the member list stay behind membership.

Who can join

JoiningWhat happens when someone chooses to join
Invitation onlyNobody can join on their own; owners and admins invite from the room.
Request to joinA join request is created; an owner or admin approves or declines it.
Open to joinThe person becomes a member immediately, after the room's access review.

Open to join is only available for rooms in private security mode. Regulated rooms always require an invitation or a reviewed request.

Manage a community

Owners and admins see Community settings on the community page. From there you can change the handle, summary, category, tags, discovery, joining, and who may see the member list. Everything else (members, invitations, messages, resources, closing the room) works exactly as it does for any Room.

Closing the room removes the community from Discover. Reopening it brings it back.

Through the API

Every action here is available as a /v2 REST resource:

  • GET /v2/messaging/communities?scope=discover|mine lists communities
  • GET /v2/messaging/communities/{handle} reads a profile
  • POST /v2/messaging/communities/{handle}/join joins or requests to join
  • GET and PUT /v2/messaging/rooms/{roomId}/community read and change the settings

See the API reference for request and response shapes.

On this page