---
title: "Changes to POST /guilds/{guild_id}/roles"
method: POST
path: "/guilds/{guild_id}/roles"
---

# Changes to POST /guilds/{guild_id}/roles

`POST /guilds/{guild_id}/roles`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 116 revisions.

- **2026-06-05** `693bf1f99bba`: 1 breaking
- **2026-05-05** `1319a0b28263`: 1 breaking
- **2026-02-04** `e200830e509a`: 5 info
- **2026-01-07** `134fefdde0ed`: 1 info
- **2025-09-02** `cc597ccd2f8e`: 2 breaking, 12 info

## Changes

- **2026-06-05** `693bf1f99bba`: 1 breaking
  - removed the required property `description` from the response with the `200` status
- **2026-05-05** `1319a0b28263`: 1 breaking
  - the `name` request property's minLength was increased from `0` to `1`
- **2026-02-04** `e200830e509a`: 5 info
  - the response property `colors/secondary_color` became required for the status `200`
  - the response property `colors/tertiary_color` became required for the status `200`
  - the response property `description` became required for the status `200`
  - the response property `icon` became required for the status `200`
  - the response property `unicode_emoji` became required for the status `200`
- **2026-01-07** `134fefdde0ed`: 1 info
  - added the new optional request property `colors`
- **2025-09-02** `cc597ccd2f8e`: 2 breaking, 12 info
  - the `colors` response's property type changed from no type to `object` for status `200`
  - the `tags` response's property type changed from no type to `object` for status `200`
  - added the optional property `colors/secondary_color` to the response with the `200` status
  - added the optional property `colors/tertiary_color` to the response with the `200` status
  - added the optional property `tags/available_for_purchase` to the response with the `200` status
  - added the optional property `tags/bot_id` to the response with the `200` status
  - added the optional property `tags/guild_connections` to the response with the `200` status
  - added the optional property `tags/integration_id` to the response with the `200` status
  - added the optional property `tags/premium_subscriber` to the response with the `200` status
  - added the optional property `tags/subscription_listing_id` to the response with the `200` status
  - the response property `colors` became required for the status `200`
  - removed `#/components/schemas/GuildRoleColorsResponse, subschema #1` from the `colors` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/GuildRoleTagsResponse, subschema #1` from the `tags` response property `oneOf` list for the response status `200`
  - added the required property `colors/primary_color` to the response with the `200` status

---

[Operation](https://skmtc.dev/discord/apis/discord-http-api-preview/docs/guilds/:guild_id/roles/post.md) - [API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) - [Page](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/roles/post)