Create club map review activity

POST https://live-services.trackmania.nadeo.live/api/token/club/{clubId}/map-review/create

Headers:


Path parameters:

  • {clubId} integer The ID of the club where the map review activity should be created *

Body parameters:

  • {name} string The name of the new map review activity *
    Maximum: 20 characters
  • {timeLimit} integer The maximum time per map, in seconds
    Maximum: 3600 Default: 180
  • {scalable} integer Whether a new server should be created when the map review room is full (1) or not (0)
    Default: 1
  • {maxPlayer} integer The maximum number of players allowed in the map review room
    Maximum: 100 Default: 64
  • {allowVoteSkipMap} integer Whether to allow players to start a vote to skip the current map (1) or not (0)
    Default: 0
  • {submissionLimitation} integer Whether to allow players to only submit a single track per hour (1) or not (0)
    Default: 0
  • {folderId} integer The ID of the folder where the map review activity should be created
    Default: 0

The request body is an object containing the map review details:

{
  "name": name,
  "timeLimit": timeLimit,
  "scalable": scalable,
  "maxPlayer": maxPlayer,
  "allowVoteSkipMap": allowVoteSkipMap,
  "submissionLimitation": submissionLimitation,
  "folderId": folderId
}

Creates a map review activity in a club.


Remarks:

  • This endpoint is only useful with tokens authenticated through Ubisoft user accounts (as opposed to dedicated server accounts).
  • As of 2024-01-17, this endpoint's response links to .dds media files by default, while several scaled .png/.jpg versions are available using separate fields (see example below for reference). This only applies for custom media files, and not for preset themes.
  • See the glossary for more information about folders.

Example request:

https://live-services.trackmania.nadeo.live/api/token/club/103034/map-review/create
{
  "name": "My tracks",
  "timeLimit": 180,
  "scalable": 1,
  "maxPlayer": 64,
  "allowVoteSkipMap": 0,
  "submissionLimitation": 0,
  "folderId": 0
}

Example response:

{
  "creationTimestamp": 1772060908,
  "clubName": "Fort's club",
  "id": 1008026,
  "scalable": true,
  "public": true,
  "game2webUrl": "https://www.trackmania.com/clubs/103034/track-reviews/1008026",
  "activityId": 1008026,
  "name": "My tracks",
  "clubId": 103034,
  "mediaUrlPngSmall": "",
  "mediaUrl": "",
  "latestEditorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "mapReviewUid": "club_103034_1008026",
  "mediaUrlPngLarge": "",
  "maxPlayer": 64,
  "mediaTheme": "",
  "popularityLevel": 0,
  "submittedMapCount": 0,
  "submissionLimitation": false,
  "creatorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "timeLimit": 180,
  "allowVoteSkipMap": false,
  "mediaUrlDds": "",
  "mediaUrlPngMedium": ""
}

If the club does not exist or the authenticated account is not a member of the club, the response will contain an error:

[
  "clubMemberRole:error-notMember"
]

If the authenticated account does not have enough permissions in the club to create a map review activity, the response will contain an error:

[
  "clubMemberRole:error-notContentCreator"
]