---
title: "Changes to Refresh legacy roster snapshots"
method: POST
path: "/v2/roster/refresh"
---

# Changes to Refresh legacy roster snapshots

`POST /v2/roster/refresh`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-09-09** `9ec0debedfc6`: 16 breaking, 32 info

## Changes

- **2026-09-09** `9ec0debedfc6`: 16 breaking, 32 info
  - the `query` request parameter `server_id` became required
  - response property `refreshed_rosters/items/clan_badge` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/clan_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/event_start_time` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/max_th` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/members/items/hero_level_sum` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/members/items/league_id` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/members/items/max_percent` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/members/items/townhall` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/members/items/trophies` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/min_signups` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/min_th` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/recurrence_day_of_month` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `refreshed_rosters/items/recurrence_days` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - the `refreshed_rosters/items/id` response's property format changed from `uuid` to no format for status `200`
  - the `refreshed_rosters/items/members/items/answers` response's property type changed from `object` to no type for status `200`
  - api operation id `dashboardRefreshRosters` 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
  - for the `query` request parameter `server_id`, the type was generalized from `integer` to `string`
  - removed the non-success response with the status `400`
  - added the optional property `refreshed_rosters/items/members/items/added_at` to the response with the `200` status
  - added the optional property `refreshed_rosters/items/members/items/error_details` to the response with the `200` status
  - added the optional property `refreshed_rosters/items/members/items/hitrate` to the response with the `200` status
  - added the optional property `refreshed_rosters/items/members/items/is_in_family` to the response with the `200` status
  - added the optional property `refreshed_rosters/items/members/items/last_updated` to the response with the `200` status
  - added the optional property `refreshed_rosters/items/members/items/member_status` to the response with the `200` status
  - added the optional property `refreshed_rosters/items/signup_questions` to the response with the `200` status
  - the response property `message` became required for the status `200`
  - the response property `refreshed_rosters` became required for the status `200`
  - the response property `refreshed_rosters/items/alias` became required for the status `200`
  - the response property `refreshed_rosters/items/columns` became required for the status `200`
  - the response property `refreshed_rosters/items/created_at` became required for the status `200`
  - the response property `refreshed_rosters/items/id` became required for the status `200`
  - the response property `refreshed_rosters/items/members` became required for the status `200`
  - the response property `refreshed_rosters/items/members/items/hero_level_sum` became required for the status `200`
  - the response property `refreshed_rosters/items/members/items/name` became required for the status `200`
  - the response property `refreshed_rosters/items/members/items/tag` became required for the status `200`
  - the response property `refreshed_rosters/items/members/items/townhall` became required for the status `200`
  - …8 more

---

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