app.tempomusic.moderation.createReport

lexicons.tempomusic.fan

Documentation

Submit a user-initiated report on a post, reply, or actor account. The reporter DID is read from the authenticated principal. Reports are dedupe-forever on (reporter, subject): a duplicate submission returns the existing report id with `deduped: true` and no new row is inserted. Per-reporter rate limit applies (5/hour, 50/day). Reports are server-side records only — they are NEVER published as PDS records, never broadcast on the firehose, and are only readable by moderators via the admin surface.

main procedure

Submit a user-initiated report on a post, reply, or actor account. The reporter DID is read from the authenticated principal. Reports are dedupe-forever on (reporter, subject): a duplicate submission returns the existing report id with `deduped: true` and no new row is inserted. Per-reporter rate limit applies (5/hour, 50/day). Reports are server-side records only — they are NEVER published as PDS records, never broadcast on the firehose, and are only readable by moderators via the admin surface.

Input

Encodingapplication/json
details string Optional

Free-text context. Required when reasonType is `other`; optional otherwise.

maxLength: 500 bytesmaxGraphemes: 500 graphemes
subject union Required

The reported entity. Discriminated by $type.

Output

Encodingapplication/json
deduped boolean Required

True when the call hit the (reporter, subject) dedupe constraint and no new row was inserted.

reportId integer Required

Identifier of the report row. Same value returned for the original submission and any subsequent duplicate.

Errors

RateLimited The reporter has exceeded the per-hour or per-day report limit. Try again later.
InvalidSubject The subject union carries a value outside the supported $type set, or is malformed (missing uri/cid/did).
DetailsRequired reasonType is `other` but `details` was empty. Free-text context is mandatory for the catch-all reason.
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 
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "subject",
        "reasonType"
      ],
      "properties": {
        "details": {
          "type": "string",
          "maxLength": 500,
          "description": "Free-text context. Required when reasonType is `other`; optional otherwise.",
          "maxGraphemes": 500
        },
        "subject": {
          "refs": [
            "app.tempomusic.moderation.defs#postSubject",
            "app.tempomusic.moderation.defs#replySubject",
            "app.tempomusic.moderation.defs#accountSubject"
          ],
          "type": "union",
          "description": "The reported entity. Discriminated by $type."
        },
        "reasonType": {
          "ref": "app.tempomusic.moderation.defs#reasonType",
          "type": "ref"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "RateLimited",
      "description": "The reporter has exceeded the per-hour or per-day report limit. Try again later."
    },
    {
      "name": "InvalidSubject",
      "description": "The subject union carries a value outside the supported $type set, or is malformed (missing uri/cid/did)."
    },
    {
      "name": "DetailsRequired",
      "description": "reasonType is `other` but `details` was empty. Free-text context is mandatory for the catch-all reason."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "reportId",
        "deduped"
      ],
      "properties": {
        "deduped": {
          "type": "boolean",
          "description": "True when the call hit the (reporter, subject) dedupe constraint and no new row was inserted."
        },
        "reportId": {
          "type": "integer",
          "minimum": 1,
          "description": "Identifier of the report row. Same value returned for the original submission and any subsequent duplicate."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Submit a user-initiated report on a post, reply, or actor account. The reporter DID is read from the authenticated principal. Reports are dedupe-forever on (reporter, subject): a duplicate submission returns the existing report id with `deduped: true` and no new row is inserted. Per-reporter rate limit applies (5/hour, 50/day). Reports are server-side records only — they are NEVER published as PDS records, never broadcast on the firehose, and are only readable by moderators via the admin surface."
}

Lexicon Garden

@