tools.ozone.report.createActivity

ozone-lexicons.bsky.social

Documentation

Register an activity on a report. For state-change activity types, validates the transition and updates report.status atomically.

main procedure

Register an activity on a report. For state-change activity types, validates the transition and updates report.status atomically.

Input

Encodingapplication/json
activity union Required

The type of activity to record.

eventId integer Optional

ID of the report moderation event. Resolves to the report created from that event. Exactly one of reportId or eventId must be provided.

internalNote string Optional

Optional moderator-only note. Not visible to reporters.

isAutomated boolean Optional

Set true when this activity is triggered by an automated process. Defaults to false.

publicNote string Optional

Optional public-facing note, potentially visible to the reporter.

reportId integer Optional

ID of the report to record activity on. Exactly one of reportId or eventId must be provided.

Output

Encodingapplication/json

Errors

ReportNotFound No report exists with the given reportId or eventId
InvalidStateTransition The requested state transition is not permitted from the report's current status
AlreadyInTargetState The report is already in the status implied by this activity type
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "description": "Register an activity on a report. For state-change activity types, validates the transition and updates report.status atomically.",
  "errors": [
    {
      "description": "No report exists with the given reportId or eventId",
      "name": "ReportNotFound"
    },
    {
      "description": "The requested state transition is not permitted from the report's current status",
      "name": "InvalidStateTransition"
    },
    {
      "description": "The report is already in the status implied by this activity type",
      "name": "AlreadyInTargetState"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "activity": {
          "description": "The type of activity to record.",
          "refs": [
            "tools.ozone.report.defs#queueActivity",
            "tools.ozone.report.defs#assignmentActivity",
            "tools.ozone.report.defs#escalationActivity",
            "tools.ozone.report.defs#closeActivity",
            "tools.ozone.report.defs#reopenActivity",
            "tools.ozone.report.defs#noteActivity"
          ],
          "type": "union"
        },
        "eventId": {
          "description": "ID of the report moderation event. Resolves to the report created from that event. Exactly one of reportId or eventId must be provided.",
          "type": "integer"
        },
        "internalNote": {
          "description": "Optional moderator-only note. Not visible to reporters.",
          "type": "string"
        },
        "isAutomated": {
          "default": false,
          "description": "Set true when this activity is triggered by an automated process. Defaults to false.",
          "type": "boolean"
        },
        "publicNote": {
          "description": "Optional public-facing note, potentially visible to the reporter.",
          "type": "string"
        },
        "reportId": {
          "description": "ID of the report to record activity on. Exactly one of reportId or eventId must be provided.",
          "type": "integer"
        }
      },
      "required": [
        "activity"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "activity": {
          "ref": "tools.ozone.report.defs#reportActivityView",
          "type": "ref"
        }
      },
      "required": [
        "activity"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@