# Reorder rules

Updates the display ordering of multiple rules at once by providing new ordering values. Requires authentication and the Rules.Manage RBAC permission. Each reorder operation is logged individually in the audit trail. Returns the complete updated list of rules after reordering.

RBAC: requires Rules.Manage

Endpoint: POST /api/v1/rules/reorder
Version: 1.0
Security: header

## Request fields (application/json):

  - `id` (string, required)
    The unique identifier of the rule to reorder
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `ordering` (integer, required)
    New display order position (lower values appear first)
    Example: 1000

## Response 200 fields (application/json):

  - `text` (string, required)
    The rule text that defines expected behavior or policy (max 500 characters)
    Example: "Be respectful to all members"

  - `hint` (string, required)
    Additional context or clarification for the rule (max 500 characters)
    Example: "This includes no harassment, personal attacks, or discriminatory language"

  - `ordering` (integer, required)
    Display order position - rules with lower values appear first
    Example: 1000

  - `id` (string, required)
    Unique identifier for the rule
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation


## Response 400 fields