Lexicon Garden

social.colibri.beta.thread.update

Renames, closes, reopens or locks a thread, or changes who may read it. An absent field leaves the current value unchanged.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · procedure
Kindprocedure
Authoritythread.beta.colibri.social
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

closed

boolean

Closes the thread when true and reopens it when false. Absent leaves the current value unchanged.

locked

boolean

Locks the thread when true and unlocks it when false. Absent leaves the current value unchanged.

name

string

The thread's title. Absent leaves the current value unchanged.

  • minLength: 1
  • maxLength: 128

thread

requiredstring · space-ref

The thread to update.

visibleToMembers

array

Members that may read this thread beyond visibleToRoles.

itemsstring · did

A member.

visibleToRoles

array

Roles that may read this thread. Empty means everyone who may read the channel may read the thread.

itemsstring · record-key

A role.

Output

application/json

thread

requiredref

The thread, after the update.

Reference

Errors

AuthRequired

The request has no valid service auth.

Forbidden

The requesting user lacks the thread.manage permission and is not the user who opened the thread renaming, closing or reopening it. Changing visibility or locking always needs thread.manage, and the user who opened a locked thread can't close or reopen it.

ThreadNotFound

No thread matches the given space reference.

RoleHierarchy

The requesting user cannot grant a role that outranks their own.

InvalidRequest

The arguments are inconsistent or malformed beyond schema validation.

CredentialsUnavailable

The AppView cannot act as the community because its stored credentials are missing or unusable.

Similar lexicons

semantic match

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

  • social.colibri.beta.bridge.updateThread

    procedure

    Renames a thread the calling bridge opened.

  • social.colibri.beta.thread

    record

    A thread's configuration, including the link to the channel it belongs to. Lives at key 'self' in the thread's own space and is written only by the community.

  • social.colibri.beta.thread.create

    procedure not from the namespace authority

    Opens a thread beside a text channel. This creates a space for the thread, then writes the thread's configuration record at key 'self' inside it. The anchor message is referenced rather than copied, so it stays in its author's repo in the channel where it was written.

  • social.colibri.beta.thread.defs

    A thread as the AppView serves it. The thread's identity is its space.

  • social.colibri.beta.category.update

    procedure

    Updates a category's name and the permissions its channels inherit.