---
title: "PATCH /api/guilds/{guild_id}/roles/"
method: PATCH
path: "/api/guilds/{guild_id}/roles/"
tags: ["api"]
---

# PATCH /api/guilds/{guild_id}/roles/

`PATCH /api/guilds/{guild_id}/roles/`

## Path parameters

- `guild_id` string, required

## Request body

- object[]
  - `id` string, required
  - `position` integer, required

## Response `200`

- RoleResponse[]
  - `id` string, required — A Twitter-like snowflake, except the epoch is 2015-01-01T00:00:00.000Z ``` If we have a snowflake '266241948824764416' we can represent it as binary: 64 22 17 12 0 000000111011000111100001101001000101000000 00001 00000 000000000000 number of ms since Discord epoch worker pid increment ```
  - `name` string, required
  - `description` string, nullable, required
  - `color` integer, required
  - `colors` RoleColors, required
    - `primary_color` integer, required
    - `secondary_color` integer
    - `tertiary_color` integer
  - `hoist` boolean, required
  - `icon` string, nullable
  - `unicode_emoji` string, nullable
  - `position` integer, required
  - `permissions` string, required
  - `managed` boolean, required
  - `mentionable` boolean, required
  - `flags` integer
  - `tags` RoleTags
    - `bot_id` string — A Twitter-like snowflake, except the epoch is 2015-01-01T00:00:00.000Z ``` If we have a snowflake '266241948824764416' we can represent it as binary: 64 22 17 12 0 000000111011000111100001101001000101000000 00001 00000 000000000000 number of ms since Discord epoch worker pid increment ```
    - `integration_id` string — A Twitter-like snowflake, except the epoch is 2015-01-01T00:00:00.000Z ``` If we have a snowflake '266241948824764416' we can represent it as binary: 64 22 17 12 0 000000111011000111100001101001000101000000 00001 00000 000000000000 number of ms since Discord epoch worker pid increment ```
    - `subscription_listing_id` string — A Twitter-like snowflake, except the epoch is 2015-01-01T00:00:00.000Z ``` If we have a snowflake '266241948824764416' we can represent it as binary: 64 22 17 12 0 000000111011000111100001101001000101000000 00001 00000 000000000000 number of ms since Discord epoch worker pid increment ```
    - `premium_subscriber` boolean, nullable
    - `available_for_purchase` boolean, nullable
    - `guild_connections` boolean, nullable

## Other responses

- `400`
- `403`

---

[API](https://skmtc.net/spacebarchat/apis/spacebar-server.md) · [All operations](https://skmtc.net/spacebarchat/apis/spacebar-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spacebarchat/spacebar-server/versions/5411ecffc184/schema)