tools.ozone.moderation.emitEvent

POST 
/xrpc/tools.ozone.moderation.emitEvent

This endpoint is part of the Ozone moderation service APIs. Requests usually require authentication, are directed to the user's PDS intance, and proxied to the Ozone instance indicated by the DID in the service proxying header. Admin authenentication may also be possible, with request sent directly to the Ozone instance.

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

Take a moderation action on an actor.

Request

application/json

Body

required

event

object

required

oneOf

tools.ozone.moderation.defs.modEventTakedown

comment string

durationInHours integer

acknowledgeAccountSubjects boolean

If true, all other reports on content authored by this account will be resolved (acknowledged).

tools.ozone.moderation.defs.modEventAcknowledge

comment string

tools.ozone.moderation.defs.modEventEscalate

comment string

tools.ozone.moderation.defs.modEventComment

comment stringrequired

sticky boolean

Make the comment persistent on the subject

tools.ozone.moderation.defs.modEventLabel

comment string

createLabelVals string[]required

negateLabelVals string[]required

tools.ozone.moderation.defs.modEventReport

comment string

isReporterMuted boolean

Set to true if the reporter was muted from reporting at the time of the event. These reports won't impact the reviewState of the subject.

reportType

object

required

oneOf

com.atproto.moderation.defs.reasonSpam

string

com.atproto.moderation.defs.reasonViolation

string

com.atproto.moderation.defs.reasonMisleading

string

com.atproto.moderation.defs.reasonSexual

string

com.atproto.moderation.defs.reasonRude

string

com.atproto.moderation.defs.reasonOther

string

com.atproto.moderation.defs.reasonAppeal

string

tools.ozone.moderation.defs.modEventMute

comment string

durationInHours integerrequired

tools.ozone.moderation.defs.modEventUnmute

comment string

Describe reasoning behind the reversal.

tools.ozone.moderation.defs.modEventMuteReporter

comment string

durationInHours integerrequired

tools.ozone.moderation.defs.modEventUnmuteReporter

comment string

Describe reasoning behind the reversal.

tools.ozone.moderation.defs.modEventReverseTakedown

comment string

Describe reasoning behind the reversal.

tools.ozone.moderation.defs.modEventResolveAppeal

comment string

Describe resolution.

tools.ozone.moderation.defs.modEventEmail

subjectLine stringrequired

The subject line of the email sent to the user.

content string

The content of the email sent to the user.

comment string

Additional comment about the outgoing comm.

tools.ozone.moderation.defs.modEventTag

add string[]required

remove string[]required

comment string

Additional comment about added/removed tags.

subject

object

required

oneOf

com.atproto.admin.defs.repoRef

did didrequired

com.atproto.repo.strongRef

uri at-urirequired

cid cidrequired
subjectBlobCids cid[]
createdBy didrequired

Responses

200

OK

application/json

Schema

Schema

id integerrequired

event

object

required

oneOf

tools.ozone.moderation.defs.modEventTakedown

comment string

durationInHours integer

acknowledgeAccountSubjects boolean

If true, all other reports on content authored by this account will be resolved (acknowledged).

tools.ozone.moderation.defs.modEventReverseTakedown

comment string

Describe reasoning behind the reversal.

tools.ozone.moderation.defs.modEventComment

comment stringrequired

sticky boolean

Make the comment persistent on the subject

tools.ozone.moderation.defs.modEventReport

comment string

isReporterMuted boolean

Set to true if the reporter was muted from reporting at the time of the event. These reports won't impact the reviewState of the subject.

reportType

object

required

oneOf

com.atproto.moderation.defs.reasonSpam

string

com.atproto.moderation.defs.reasonViolation

string

com.atproto.moderation.defs.reasonMisleading

string

com.atproto.moderation.defs.reasonSexual

string

com.atproto.moderation.defs.reasonRude

string

com.atproto.moderation.defs.reasonOther

string

com.atproto.moderation.defs.reasonAppeal

string

tools.ozone.moderation.defs.modEventLabel

comment string

createLabelVals string[]required

negateLabelVals string[]required

tools.ozone.moderation.defs.modEventAcknowledge

comment string

tools.ozone.moderation.defs.modEventEscalate

comment string

tools.ozone.moderation.defs.modEventMute

comment string

durationInHours integerrequired

tools.ozone.moderation.defs.modEventUnmute

comment string

Describe reasoning behind the reversal.

tools.ozone.moderation.defs.modEventMuteReporter

comment string

durationInHours integerrequired

tools.ozone.moderation.defs.modEventUnmuteReporter

comment string

Describe reasoning behind the reversal.

tools.ozone.moderation.defs.modEventEmail

subjectLine stringrequired

The subject line of the email sent to the user.

content string

The content of the email sent to the user.

comment string

Additional comment about the outgoing comm.

tools.ozone.moderation.defs.modEventResolveAppeal

comment string

Describe resolution.

tools.ozone.moderation.defs.modEventDivert

comment string

tools.ozone.moderation.defs.modEventTag

add string[]required

remove string[]required

comment string

Additional comment about added/removed tags.

subject

object

required

oneOf

com.atproto.admin.defs.repoRef

did didrequired

com.atproto.repo.strongRef

uri at-urirequired

cid cidrequired

chat.bsky.convo.defs.messageRef

did didrequired

convoId stringrequired

messageId stringrequired
subjectBlobCids string[]required
createdBy didrequired
createdAt date-timerequired
creatorHandle string
subjectHandle string

Example (from schema)

{
  "id": 0,
  "event": {},
  "subject": {},
  "subjectBlobCids": [
    "string"
  ],
  "createdBy": "string",
  "createdAt": "2024-11-07T00:27:32.130Z",
  "creatorHandle": "string",
  "subjectHandle": "string"
}

400

Bad Request

application/json

Schema

Schema

error stringrequired

Possible values: [InvalidRequest, ExpiredToken, InvalidToken, SubjectHasAction]

message stringrequired

Example (from schema)

{
  "error": "InvalidRequest",
  "message": "string"
}

401

Unauthorized

application/json

Schema

Schema

error required
message stringrequired

Example (from schema)

{
  "message": "string"
}

Loading...