Skip to main content

tools.ozone.report.closeReports

#main​

Close eligible reports on a subject matching the given criteria, optionally linking an existing moderation action. Assigned, escalated, and actively assigned reports are excluded. Reports whose current status does not permit a transition to closed are skipped silently.

Input​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
subjectstring (uri)-✅Subject DID (account-level reports) or AT-URI (record-level reports) whose reports should be closed.
includeAllOwnedboolean-❌If true, also close reports on all subjects owned by the account, including records, messages, and conversations. Only valid when subject is an account DID.
reportTypesarray of string-❌If nonempty, only reports of the given report types (fully qualified reason NSIDs) are closed. When omitted or empty, all eligible reports in the requested subject scope are targeted, except excludedReportTypes. Assigned and escalated reports are always excluded.
excludedReportTypesarray of string-❌Reports of these types (fully qualified reason NSIDs) are excluded from closure and left unchanged. When omitted or empty, no report types are excluded.
actionEventIdinteger-❌Optional existing moderation event that closes reports. It must target the exact subject or its owning account; account-wide closure requires an account event. The event is linked to each closed report and may predate the report. The link does not imply the action is still in effect.
internalNotestring-❌Optional moderator-only note recorded on each close activity. Not visible to reporters.
isAutomatedboolean-❌Set true when this action is triggered by an automated process. Defaults to false.
metaunknown-❌Optional metadata for the report activities. Lifecycle and resolution fields are controlled by the service.

Output​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
closedCountinteger-✅Number of reports that were transitioned to closed.
reportIdsarray of integer-✅IDs of the reports that were closed.