"Message the mods": opens the caller's private thread with the Community's mod team, or continues it. Each account has one thread per Community, and a message reopens it if the mod team archived it. Anyone signed in may write, including a muted or banned member; whoever holds manage-mail answers with replyModmail instead. Rate-limited per sender.
Input
application/jsoncommunity
stringat-uri
Required
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
text
string
Required
No description available.
maxLength: 2000 bytesminLength: 1 bytesOutput
application/jsonmessage
refcom.getorbyt.community.defs#modmailMessageView
Required
No description available.
thread
refcom.getorbyt.community.defs#modmailThreadView
Required
No description available.
Errors
AuthenticationRequired
CommunityNotFound
InvalidRequest
InvalidAction
The caller holds manage-mail, so they answer members rather than write to their own team. RateLimitExceeded
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"description": "\"Message the mods\": opens the caller's private thread with the Community's mod team, or continues it. Each account has one thread per Community, and a message reopens it if the mod team archived it. Anyone signed in may write, including a muted or banned member; whoever holds manage-mail answers with replyModmail instead. Rate-limited per sender.",
"errors": [
{
"name": "AuthenticationRequired"
},
{
"name": "CommunityNotFound"
},
{
"name": "InvalidRequest"
},
{
"description": "The caller holds manage-mail, so they answer members rather than write to their own team.",
"name": "InvalidAction"
},
{
"name": "RateLimitExceeded"
}
],
"input": {
"encoding": "application/json",
"schema": {
"properties": {
"community": {
"format": "at-uri",
"type": "string"
},
"text": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"community",
"text"
],
"type": "object"
}
},
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"message": {
"ref": "com.getorbyt.community.defs#modmailMessageView",
"type": "ref"
},
"thread": {
"ref": "com.getorbyt.community.defs#modmailThreadView",
"type": "ref"
}
},
"required": [
"thread",
"message"
],
"type": "object"
}
},
"type": "procedure"
}