---
title: Edit a Leaderboard
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/patch-v1-gamecenterleaderboards-_id_
---

# Edit a Leaderboard

Modify the details of a leaderboard.

## URL

PATCH https://api.appstoreconnect.apple.com/v1/gameCenterLeaderboards/{id}

## Path Parameters

id: An opaque resource ID that uniquely identifies the resource. Obtain the leaderboard resource ID from the Get leaderboards information response.

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 409 Conflict: 422 : 429 :

## Discussion

Discussion Use leaderboard formatters to specify the unit of measurement for a Game Center leaderboard. There is a new required attribute defaultFormatter when you use Create a Leaderboard, which gives all your localizations the same formatter. You can also optionally use formatterOverride to override a specific leaderboard localization when calling Create a Leaderboard Localization or Modify a Leaderboard Localization. Before App Store Connect API version 3.0, formatters were based on localizations and were required for each localization. Legacy leaderboards created before the new addition of the Game Center APIs will not have a defaultFormatter value, the value would be null in this case. Any localizations created before the new addition of the Game Center APIs will always have a formatterOverride.

## See Also

### Creating, modifying, and deleting leaderboards

- [Create a Game Center Leaderboard](appstoreconnectapi/post-v2-gamecenterleaderboards.md)
- [Modify a Game Center Leaderboard](appstoreconnectapi/patch-v2-gamecenterleaderboards-_id_.md)
- [Modify the Activity for a Game Center Leaderboard](appstoreconnectapi/patch-v2-gamecenterleaderboards-_id_-relationships-activity.md)
- [Modify the Challenge for a Game Center Leaderboard](appstoreconnectapi/patch-v2-gamecenterleaderboards-_id_-relationships-challenge.md)
- [Delete a Game Center Leaderboard](appstoreconnectapi/delete-v2-gamecenterleaderboards-_id_.md)
- [Create a Leaderboard](appstoreconnectapi/post-v1-gamecenterleaderboards.md)
- [Edit the Relationship Between a Leaderboard and a Group Leaderboard](appstoreconnectapi/patch-v1-gamecenterleaderboards-_id_-relationships-groupleaderboard.md)
- [Modify the activity for a Game Center leaderboard](appstoreconnectapi/patch-v1-gamecenterleaderboards-_id_-relationships-activity.md)
- [Modify the challenge for a Game Center leaderboard](appstoreconnectapi/patch-v1-gamecenterleaderboards-_id_-relationships-challenge.md)
- [Delete a Leaderboard](appstoreconnectapi/delete-v1-gamecenterleaderboards-_id_.md)