> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riktra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# propose_priority_reorder

> Propose moving one priority to a different rank.

Creates a review proposal and reports every priority that would shift. Shared truth does not change until an administrator approves it through the same atomic reorder operation used by the web UI.

## Parameters

<ParamField body="priority_id" type="uuid" required>
  An active priority id returned by get\_priorities.
</ParamField>

<ParamField body="new_rank" type="integer" required>
  The requested one-based position; values beyond the end mean last.
</ParamField>

<ParamField body="rationale" type="string">
  Why the order should change, for the reviewer.
</ParamField>