# Update existing rule

Modifies an existing platform rule with updated text, hint, or ordering. Requires authentication and the Rules.Manage RBAC permission. Returns 404 if the rule does not exist. The update is logged in the audit trail.

RBAC: requires Rules.Manage

Endpoint: PUT /api/v1/rules
Version: 1.0
Security: header

## Request 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 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 400 fields