Backfill in-progress. Some lexicons and records may be missing or incomplete.

com.atproto.moderation.createReport

atproto-lexicons.bsky.social

Documentation

main procedure

Submit a moderation report regarding an atproto account or record. Implemented by moderation services (with PDS proxying), and requires auth.

Input

Encodingapplication/json
modTool ref#modTool Optional

No description provided.

reason string Optional

Additional context about the content and violation.

maxLength: 20000 bytesmaxGraphemes: 2000 graphemes
subject union Required

No description provided.

Output

Encodingapplication/json
createdAt stringdatetime Required

An RFC 3339 formatted timestamp.

id integer Required

No description provided.

reason string Optional

No description provided.

reportedBy stringdid Required

A decentralized identifier (DID).

subject union Required

No description provided.

Try It

Direct PDS XRPC methods (com.atproto.*) are disabled in Try It for security reasons.

These methods interact directly with Personal Data Servers and require careful handling. Use a dedicated client or CLI tool instead.
View raw schema 
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "reasonType",
        "subject"
      ],
      "properties": {
        "reason": {
          "type": "string",
          "maxLength": 20000,
          "description": "Additional context about the content and violation.",
          "maxGraphemes": 2000
        },
        "modTool": {
          "ref": "#modTool",
          "type": "ref"
        },
        "subject": {
          "refs": [
            "com.atproto.admin.defs#repoRef",
            "com.atproto.repo.strongRef"
          ],
          "type": "union"
        },
        "reasonType": {
          "ref": "com.atproto.moderation.defs#reasonType",
          "type": "ref",
          "description": "Indicates the broad category of violation the report is for."
        }
      }
    },
    "encoding": "application/json"
  },
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "id",
        "reasonType",
        "subject",
        "reportedBy",
        "createdAt"
      ],
      "properties": {
        "id": {
          "type": "integer"
        },
        "reason": {
          "type": "string",
          "maxLength": 20000,
          "maxGraphemes": 2000
        },
        "subject": {
          "refs": [
            "com.atproto.admin.defs#repoRef",
            "com.atproto.repo.strongRef"
          ],
          "type": "union"
        },
        "createdAt": {
          "type": "string",
          "format": "datetime"
        },
        "reasonType": {
          "ref": "com.atproto.moderation.defs#reasonType",
          "type": "ref"
        },
        "reportedBy": {
          "type": "string",
          "format": "did"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Submit a moderation report regarding an atproto account or record. Implemented by moderation services (with PDS proxying), and requires auth."
}
modTool object

Moderation tool information for tracing the source of the action

Properties

meta unknown Optional

Additional arbitrary metadata about the source

name string Required

Name/identifier of the source (e.g., 'bsky-app/android', 'bsky-web/chrome')

View raw schema 
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "meta": {
      "type": "unknown",
      "description": "Additional arbitrary metadata about the source"
    },
    "name": {
      "type": "string",
      "description": "Name/identifier of the source (e.g., 'bsky-app/android', 'bsky-web/chrome')"
    }
  },
  "description": "Moderation tool information for tracing the source of the action"
}

Lexicon Garden

@