post/reports/guild

Report guild

Submits a report about a guild to moderators for policy violation review.

report_guild

Request body

application/json

json

{
  "type": "object",
  "properties": {
    "guild_id": {
      "$ref": "#/components/schemas/SnowflakeType"
    },
    "category": {
      "type": "string",
      "enum": [
        "harassment",
        "hate_speech",
        "extremist_community",
        "illegal_activity",
        "child_safety",
        "raid_coordination",
        "spam",
        "malware_distribution",
        "other"
      ],
      "x-enumNames": [
        "harassment",
        "hate_speech",
        "extremist_community",
        "illegal_activity",
        "child_safety",
        "raid_coordination",
        "spam",
        "malware_distribution",
        "other"
      ],
      "x-enumDescriptions": [
        "Guild facilitates harassment, bullying, or intimidation",
        "Guild promotes hatred against protected groups",
        "Guild promotes extremist or terrorist ideologies",
        "Guild promotes or facilitates illegal activities",
        "Guild endangers minors or hosts child abuse content",
        "Guild coordinates attacks on other communities",
        "Guild used for spamming or bulk messaging",
        "Guild distributes malware or malicious software",
        "Other violations not covered by specific categories"
      ],
      "description": "Category of the guild report"
    },
    "invite_code": {
      "type": "string",
      "description": "Invite code proving access to the guild (required when not a member of a non-discoverable guild)"
    }
  },
  "required": [
    "guild_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"
  ]
}