Permanently ban an account: all of its content disappears from the public read surface and no surface can lift the state. Escalating an active suspension replaces it. Requires the `superAdmin` role. Writes an `accountBanned` audit row. Federation caveat: the ban blocks this DID — re-registration under a fresh DID is structurally possible in AT Protocol.
Input
application/jsoncloseAttachedReports
boolean
Optional
Same semantics as suspendAccount: closes `open`/`underReview` reports against the ACCOUNT subject in the same transaction, with linked `reportClosedByCascade` audit rows. Reports against individual posts/replies stay open.
did
stringdid
Required
A decentralized identifier (DID).
notifyUser
boolean
Optional
When true, persist a moderation notice addressed to the affected user (content author or account holder). Delivery is out of scope.
reason
string
Required
No description available.
maxLength: 2000 bytesminLength: 1 bytesOutput
application/jsonattachedReportsClosed
integer
Required
Number of account-subject reports auto-closed in this transaction. Zero when closeAttachedReports=false or none were open.
auditEntryId
integer
Required
No description available.
Errors
Forbidden
The caller is not a super-admin. AccountAlreadyBanned
The account is already banned. Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"description": "Permanently ban an account: all of its content disappears from the public read surface and no surface can lift the state. Escalating an active suspension replaces it. Requires the `superAdmin` role. Writes an `accountBanned` audit row. Federation caveat: the ban blocks this DID — re-registration under a fresh DID is structurally possible in AT Protocol.",
"errors": [
{
"description": "The caller is not a super-admin.",
"name": "Forbidden"
},
{
"description": "The account is already banned.",
"name": "AccountAlreadyBanned"
}
],
"input": {
"encoding": "application/json",
"schema": {
"properties": {
"closeAttachedReports": {
"default": false,
"description": "Same semantics as suspendAccount: closes `open`/`underReview` reports against the ACCOUNT subject in the same transaction, with linked `reportClosedByCascade` audit rows. Reports against individual posts/replies stay open.",
"type": "boolean"
},
"did": {
"format": "did",
"type": "string"
},
"notifyUser": {
"default": false,
"description": "When true, persist a moderation notice addressed to the affected user (content author or account holder). Delivery is out of scope.",
"type": "boolean"
},
"reason": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"did",
"reason"
],
"type": "object"
}
},
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"attachedReportsClosed": {
"description": "Number of account-subject reports auto-closed in this transaction. Zero when closeAttachedReports=false or none were open.",
"minimum": 0,
"type": "integer"
},
"auditEntryId": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"auditEntryId",
"attachedReportsClosed"
],
"type": "object"
}
},
"type": "procedure"
}