---
title: "Update a map's data / change its status"
method: PATCH
path: "/v1/admin/maps/{mapID}"
tags: ["Admin"]
---

# Update a map's data / change its status

`PATCH /v1/admin/maps/{mapID}`

## Request

- Base URL: `https://api.momentum-mod.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.momentum-mod.org/v1/admin/maps/{mapID}`
- Auth: HTTP bearer

## Path parameters

- `mapID` number, required

## Request body

- UpdateMapDto
  - `name` string: The name of the map
  - `suggestions` MapSubmissionSuggestionDto[]
    - `trackNum` number, required: Track number the suggestion refers to
    - `trackType` 0 | 1 | 2, required: Type of track the suggestion refers to
    - `gamemode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13, required: Gamemode the suggestion is for
    - `tier` number, required: Suggested tier for the track and gamemode
    - `type` number, required: Type of leaderboard, ranked, unranked or hidden
    - `comment` string, required: General comments about the track on this gamemode
    - `tags` string[], required
  - `portingChangelog` string: Porting Changelog for the map
  - `placeholders` MapSubmissionPlaceholderDto
    - `type` 0 | 1 | 2 | 3, required
    - `description` string, required: Description of the user's contribution
    - `alias` string, required
  - `info` UpdateMapInfoDto
    - `description` string: Author-submitted description of the map
    - `youtubeID` string: ID of Youtube video for the map, for use with e.g. https://www.youtube.com/?v=[ID]
    - `creationDate` object
    - `requiredGames` string[]: Array of apps, which the map uses assets from
  - `status` 0 | 1 | 2 | 3 | 4 | 5, required
  - `submissionType` 0 | 1 | 2: Whether the submission is an original map, a port, or something unusual
  - `submitterID` number: UserID to update the submitter to
  - `finalLeaderboards` MapSubmissionApprovalDto[]
    - `trackNum` number, required: Track number the suggestion refers to
    - `trackType` 0 | 1 | 2, required: Type of track the suggestion refers to
    - `gamemode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13, required: Gamemode the suggestion is for
    - `tier` number, required: Suggested tier for the track and gamemode
    - `type` number, required
    - `tags` string[], required: Final tags
  - `leaderboards` MapSubmissionSuggestionDto[]
    - `trackNum` number, required: Track number the suggestion refers to
    - `trackType` 0 | 1 | 2, required: Type of track the suggestion refers to
    - `gamemode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13, required: Gamemode the suggestion is for
    - `tier` number, required: Suggested tier for the track and gamemode
    - `type` number, required: Type of leaderboard, ranked, unranked or hidden
    - `comment` string, required: General comments about the track on this gamemode
    - `tags` string[], required

## Response `204`

The map was updated successfully

## Other responses

- `400`: Invalid map update data

---

[API](https://skmtc.dev/momentum-mod/apis/momentum-mod-api.md) - [All operations](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/llms.txt) - [OpenAPI document](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/revisions/0a88cfbbcc65?raw)
