---
title: "Save Roles"
method: PUT
path: "/dashboard/bot/settings/{guild_id}/roles/"
tags: ["dashboard"]
---

# Save Roles

`PUT /dashboard/bot/settings/{guild_id}/roles/`

## Request

- Base URL: `https://api.monni.fyi` (the document declares no server; this is the origin it was published from)
- URL: `https://api.monni.fyi/dashboard/bot/settings/{guild_id}/roles/`
- Auth: HTTP bearer

## Path parameters

- `guild_id` integer, required

## Request body

- RoleSettings
  - `sticky_roles` string[], required
  - `auto_roles` string[], required
  - `chain_roles` ChainRole[], required
    - `id` string, required
    - `role_1` string, required
    - `role_2` string, required
    - `bidirectional` boolean, required
    - `remove_on_loss` boolean
  - `cross_guild_role_sync` CrossGuildSyncRole[], required
    - `id` string, required
    - `source_guild_id` string, required
    - `source_role_id` string, required
    - `target_role_id` string, required
  - `reaction_roles` ReactionRole[]
    - `id` string, required
    - `name` string, required
    - `mode` string
    - `limit_count` integer
    - `whitelist_roles` string[]
    - `blacklist_roles` string[]
    - `message_data` object
    - `buttons` RRButton[]
      - `id` string, required
      - `label` string
      - `emoji` RREmoji
        - `emoji` string, required
        - `unicode` boolean, required
        - `shortcode` string, required
      - `style` string
      - `roles` string[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-01** `c08615391337`: 1 info
  - added the new optional request property `chain_roles/items/remove_on_loss`
- **2026-09-16** `83ac8f547df8`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/monni/apis/monni-api/changes/dashboard/bot/settings/:guild_id/roles/put.md)

---

[API](https://skmtc.dev/monni/apis/monni-api.md) - [All operations](https://skmtc.dev/monni/apis/monni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monni/apis/monni-api/revisions/a35aef40d880?raw)