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

# Ranking actions

> Promote, demote and set ranks through the Lumira API.

## Supported actions

* `promote`
* `demote`
* `setrank`

## Example request

```bash theme={null}
curl -X POST "https://canary-api.lumiraranking.co.uk/v0/workspaces/{guildId}/rank-action" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "action": "setrank",
    "targetRobloxId": "1527978588",
    "roleId": "254",
    "reason": "Training completion"
  }'
```

## Common failure reasons

* Selected rank was not found.
* Ranking account is not linked.
* Ranking account lacks group write permission.
* Target user is not in the group.
* The rank is above the ranking account's permission.