Lexicon Garden

com.getorbyt.community.getModmailThread

One Modmail thread and its messages, newest first. Without member, the caller's own thread, which is absent until they first write. With another account's member, the caller needs manage-mail. Viewer-specific and never cached; reading does not mark the thread read (see updateModmailSeen).

Repository @getorbyt.com did:plc:2xrqztnmzlckb3xfuuukupso namespace authority
Details · query
Kindquery
Authoritycommunity.getorbyt.com
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

community

requiredstring · at-uri

cursor

string

Continues toward older messages.

limit

integer
  • minimum: 1
  • maximum: 50
  • default: 25

member

string · did

Whose thread. Absent means the caller's own.

Output

application/json

cursor

string

messages

requiredarray
  • maxLength: 50

Errors

AuthenticationRequired

No description in schema.

CommunityNotFound

No description in schema.

InsufficientRole

No description in schema.

InvalidRequest

No description in schema.

InvalidCursor

No description in schema.

ThreadNotFound

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.

  • com.getorbyt.community.listModmailThreads

    query

    The mod team's Modmail inbox: one thread per member, most recent message first, each marked unread when the member wrote since this moderator last read it. Requires manage-mail. Viewer-specific and never cached.

  • social.colibri.beta.thread.listThreads

    query not from the namespace authority

    Lists a community's threads, most recently active first. Threads the requesting user may not read are absent rather than refused.

  • com.getorbyt.community.updateModmailSeen

    procedure

    Marks a Modmail thread read for the caller up to seenAt. Read state is per reader: the member's own, and each moderator's own. The mark only moves forward and never past now. Sending a message marks the thread read for its sender.

  • com.getorbyt.community.manageModmailThread

    procedure

    Archives a member's Modmail thread out of the open inbox, or brings it back. Requires manage-mail. A new message from the member reopens an archived thread on its own.

  • com.getorbyt.community.replyModmail

    procedure

    Replies to a member's Modmail thread as the mod team. Requires manage-mail. Moderators cannot start a thread: they answer one a member opened. The member sees the reply in the thread and in Activity, from the team rather than from the moderator.