---
title: "Changes to Create a dashboard roster"
method: POST
path: "/v2/roster"
---

# Changes to Create a dashboard roster

`POST /v2/roster`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-09-09** `9ec0debedfc6`: 24 breaking, 40 info

## Changes

- **2026-09-09** `9ec0debedfc6`: 24 breaking, 40 info
  - the request property `alias` became required
  - the request property `members/items/tag` became required
  - the request property `roster_type` became required
  - the request property `signup_scope` became required
  - request property `members/items/hero_level_sum` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `members/items/league_id` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `members/items/townhall` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `members/items/trophies` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - the `members/items/answers` request property type changed from `object` to no type
  - response property `roster/clan_badge` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - response property `roster/clan_name` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - response property `roster/event_start_time` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/max_th` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/members/items/hero_level_sum` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/members/items/league_id` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/members/items/max_percent` list-of-types was widened by adding types `string` to media type `application/json` of response `201`
  - response property `roster/members/items/townhall` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/members/items/trophies` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/min_signups` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/min_th` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/recurrence_day_of_month` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - response property `roster/recurrence_days` list-of-types was widened by adding types `number and string` to media type `application/json` of response `201`
  - the `roster/id` response's property format changed from `uuid` to no format for status `201`
  - the `roster/members/items/answers` response's property type changed from `object` to no type for status `201`
  - api operation id `dashboardCreateRoster` was added
  - the endpoint scheme security `BotToken` was added to the API
  - the endpoint scheme security `UserToken` was added to the API
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - added the new optional request property `max_accounts_per_user`
  - added the new optional request property `server_id`
  - for the `query` request parameter `server_id`, the type was generalized from `integer` to `string`
  - request property `clan_tag` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `description` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `group_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `members/items/max_percent` list-of-types was widened by adding types `string` to media type `application/json`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - added the optional property `roster/members/items/added_at` to the response with the `201` status
  - added the optional property `roster/members/items/error_details` to the response with the `201` status
  - added the optional property `roster/members/items/hitrate` to the response with the `201` status
  - …24 more

---

[Operation](https://skmtc.dev/clashk/apis/clashking-api/docs/v2/roster/post.md) - [API](https://skmtc.dev/clashk/apis/clashking-api.md) - [Page](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/roster/post)