Mark a moderator row as revoked. The DID can no longer pass the moderator gate (latency = the moderator-cache TTL, default 30s). Requires the caller to have the `superAdmin` role. A super-admin cannot revoke themselves. Writes a `moderatorRevoked` audit row only when an active row was actually revoked. Idempotent: revoking a DID that is not currently an active moderator returns 200 with `revoked: false` and no audit row.
Input
application/jsondid
stringdid
Required
A decentralized identifier (DID).
reason
string
Optional
No description available.
maxLength: 1000 bytesOutput
application/jsonauditEntryId
integer
Optional
Present only when revoked=true.
revoked
boolean
Required
True when a previously active row was revoked. False when the DID was not an active moderator (idempotent no-op).
Errors
Forbidden
The caller is not a super-admin. CannotRevokeSelf
A super-admin cannot revoke their own row. Have another super-admin do it. 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": [
"did"
],
"properties": {
"did": {
"type": "string",
"format": "did"
},
"reason": {
"type": "string",
"maxLength": 1000
}
}
},
"encoding": "application/json"
},
"errors": [
{
"name": "Forbidden",
"description": "The caller is not a super-admin."
},
{
"name": "CannotRevokeSelf",
"description": "A super-admin cannot revoke their own row. Have another super-admin do it."
}
],
"output": {
"schema": {
"type": "object",
"required": [
"revoked"
],
"properties": {
"revoked": {
"type": "boolean",
"description": "True when a previously active row was revoked. False when the DID was not an active moderator (idempotent no-op)."
},
"auditEntryId": {
"type": "integer",
"minimum": 1,
"description": "Present only when revoked=true."
}
}
},
"encoding": "application/json"
},
"description": "Mark a moderator row as revoked. The DID can no longer pass the moderator gate (latency = the moderator-cache TTL, default 30s). Requires the caller to have the `superAdmin` role. A super-admin cannot revoke themselves. Writes a `moderatorRevoked` audit row only when an active row was actually revoked. Idempotent: revoking a DID that is not currently an active moderator returns 200 with `revoked: false` and no audit row."
}