post/reports/message

Report message

Submits a report about a message to moderators for content violation review. The reporter must be able to access the channel and target message.

report_message

Request body

application/json

json

{
  "type": "object",
  "properties": {
    "channel_id": {
      "$ref": "#/components/schemas/SnowflakeType"
    },
    "message_id": {
      "$ref": "#/components/schemas/SnowflakeType"
    },
    "category": {
      "type": "string",
      "enum": [
        "harassment",
        "hate_speech",
        "violent_content",
        "spam",
        "nsfw_violation",
        "illegal_activity",
        "doxxing",
        "self_harm",
        "child_safety",
        "malicious_links",
        "impersonation",
        "other"
      ],
      "x-enumNames": [
        "harassment",
        "hate_speech",
        "violent_content",
        "spam",
        "nsfw_violation",
        "illegal_activity",
        "doxxing",
        "self_harm",
        "child_safety",
        "malicious_links",
        "impersonation",
        "other"
      ],
      "x-enumDescriptions": [
        "Content that harasses, bullies, or intimidates users",
        "Content promoting hatred against protected groups",
        "Content depicting or promoting violence",
        "Unsolicited bulk messages or promotional content",
        "Adult content posted outside age-restricted channels",
        "Content promoting or facilitating illegal activities",
        "Content revealing private personal information",
        "Content promoting self-harm or suicide",
        "Content that endangers minors or depicts child abuse",
        "Links to malware, phishing, or other malicious sites",
        "Content falsely claiming to be another person or entity",
        "Other violations not covered by specific categories"
      ],
      "description": "Category of the message report"
    }
  },
  "required": [
    "channel_id",
    "message_id",
    "category"
  ]
}

Responses

200

Success

json

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string",
      "pattern": "^(0|[1-9][0-9]*)$",
      "description": "The unique identifier for this report"
    },
    "status": {
      "type": "string",
      "description": "Current status of the report (pending, reviewed, resolved)"
    },
    "reported_at": {
      "type": "string",
      "description": "ISO 8601 timestamp when the report was submitted"
    }
  },
  "required": [
    "report_id",
    "status",
    "reported_at"
  ]
}

400

Bad Request - The request was malformed or contained invalid data

json

{
  "type": "object",
  "properties": {
    "code": {
      "$ref": "#/components/schemas/APIErrorCode"
    },
    "message": {
      "type": "string",
      "description": "Human-readable error message"
    },
    "errors": {
      "type": "array",
      "description": "Field-specific validation errors",
      "items": {
        "$ref": "#/components/schemas/ValidationErrorItem"
      }
    }
  },
  "required": [
    "code",
    "message"
  ]
}

401

Unauthorized - Authentication is required or the token is invalid

json

{
  "type": "object",
  "properties": {
    "code": {
      "$ref": "#/components/schemas/APIErrorCode"
    },
    "message": {
      "type": "string",
      "description": "Human-readable error message"
    },
    "errors": {
      "type": "array",
      "description": "Field-specific validation errors",
      "items": {
        "$ref": "#/components/schemas/ValidationErrorItem"
      }
    }
  },
  "required": [
    "code",
    "message"
  ]
}

403

Forbidden - You do not have permission to perform this action

json

{
  "type": "object",
  "properties": {
    "code": {
      "$ref": "#/components/schemas/APIErrorCode"
    },
    "message": {
      "type": "string",
      "description": "Human-readable error message"
    },
    "errors": {
      "type": "array",
      "description": "Field-specific validation errors",
      "items": {
        "$ref": "#/components/schemas/ValidationErrorItem"
      }
    }
  },
  "required": [
    "code",
    "message"
  ]
}

429

Too Many Requests - You are being rate limited

json

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "enum": [
        "RATE_LIMITED"
      ]
    },
    "message": {
      "type": "string"
    },
    "retry_after": {
      "type": "number",
      "description": "Seconds to wait before retrying"
    },
    "global": {
      "type": "boolean",
      "description": "Whether this is a global rate limit"
    }
  },
  "required": [
    "code",
    "message",
    "retry_after"
  ]
}

500

Internal Server Error - An unexpected error occurred

json

{
  "type": "object",
  "properties": {
    "code": {
      "$ref": "#/components/schemas/APIErrorCode"
    },
    "message": {
      "type": "string",
      "description": "Human-readable error message"
    },
    "errors": {
      "type": "array",
      "description": "Field-specific validation errors",
      "items": {
        "$ref": "#/components/schemas/ValidationErrorItem"
      }
    }
  },
  "required": [
    "code",
    "message"
  ]
}