A moderator action on one post's Community-level state. Removal is scoped to the Community; only actions that change state are journaled.
Input
application/jsonaction
string
Required
No description available.
community
stringat-uri
Required
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
post
stringat-uri
Required
The linked app.bsky.feed.post URI.
reason
string
Optional
Required for removal, shown to the author, and recorded in the moderation log.
maxLength: 1000 bytesOutput
application/jsonchanged
boolean
Required
No description available.
pinned
boolean
Required
No description available.
removedAt
stringdatetime
Optional
An RFC 3339 formatted timestamp.
removedReason
string
Optional
No description available.
status
string
Required
No description available.
visible, removedErrors
CommunityNotFound
InsufficientRole
PostNotFound
InvalidAction
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"type": "procedure",
"input": {
"schema": {
"type": "object",
"required": [
"community",
"post",
"action"
],
"properties": {
"post": {
"type": "string",
"format": "at-uri",
"description": "The linked app.bsky.feed.post URI."
},
"action": {
"type": "string",
"knownValues": [
"remove",
"restore",
"pin",
"unpin"
]
},
"reason": {
"type": "string",
"maxLength": 1000,
"description": "Required for removal, shown to the author, and recorded in the moderation log."
},
"community": {
"type": "string",
"format": "at-uri"
}
}
},
"encoding": "application/json"
},
"errors": [
{
"name": "CommunityNotFound"
},
{
"name": "InsufficientRole"
},
{
"name": "PostNotFound"
},
{
"name": "InvalidAction"
}
],
"output": {
"schema": {
"type": "object",
"required": [
"status",
"pinned",
"changed"
],
"properties": {
"pinned": {
"type": "boolean"
},
"status": {
"type": "string",
"knownValues": [
"visible",
"removed"
]
},
"changed": {
"type": "boolean"
},
"removedAt": {
"type": "string",
"format": "datetime"
},
"removedReason": {
"type": "string"
}
}
},
"encoding": "application/json"
},
"description": "A moderator action on one post's Community-level state. Removal is scoped to the Community; only actions that change state are journaled."
}