# Create a rule

Creates a new platform rule with text content, optional hint explanation, and ordering priority. Requires authentication and the Rules.Manage RBAC permission. The creation is logged in the audit trail.

RBAC: requires Rules.Manage

Endpoint: POST /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

## 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