com.getorbyt.community.setAnnouncement

Sets or clears the Community's announcement, shown on its page and, when set or changed, in its members' activity as `communityAnnouncement`. Requires manage-settings. The announcement is service state rather than part of the declaration record, so a moderator granted manage-settings can set it without writing the owner's repository. Setting and clearing are both recorded in the moderation log.

Repository @getorbyt.com did:plc:2xrqztnmzlckb3xfuuukupso namespace authority
Details · procedure
Kindprocedure
Authoritycommunity.getorbyt.com
Indexed

Procedure

procedure · POST

Input

application/json

community

requiredstring · at-uri

text

string

The announcement text. Absent or blank clears the announcement. The service holds it to a shorter limit than this ceiling, which getServiceInfo serves as `community.announcementMaxCharacters`.

  • maxLength: 3000
  • maxGraphemes: 300

Output

application/json

The announcement now. Absent once cleared.

changed

requiredboolean

Errors

AuthenticationRequired

No description in schema.

CommunityNotFound

No description in schema.

InsufficientRole

No description in schema.

InvalidRequest

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.