Headers:

• Authorization: nadeo_v1 t={token} An access token for the NadeoLiveServices audience

Path parameters:

• {clubId} integer The ID of the club the activity belongs to *
• {activityId} integer The activity ID of the activity to be edited *

Body parameters:

• {name} string The new name of the activity
• {active} integer Whether the activity should be active (1) or deactivated (0)
• {featured} integer Whether the activity should be featured in the club (1) or not (0)
• {folderId} integer The ID of the folder in the club where the activity should be moved
• {mediaTheme} string The name of the theme preset to use for the activity, in lower-case
• {position} integer The position of the activity in the club's activities list
• {public} integer Whether the activity should be public (1) or private (0)

The request body is an object with the activity details to be edited:

{
  "name": name,
  "active": active,
  "featured": featured,
  "folderId": folderId,
  "mediaTheme": mediaTheme,
  "position": position,
  "public": public
}

Edits an activity in a club.

Remarks:

• This endpoint is only useful with tokens authenticated through Ubisoft user accounts (as opposed to dedicated server accounts).
• To move an activity out of a folder, set folderID to 0.
• A valid position depends on the other activities in the club, including deactivated and deleted ones. It's recommended to use one of the positions returned by the Get club activities Live endpoint.
• A list of theme presets that can be used for the mediaTheme parameter can be found in the following directory when selecting an image for a club activity: Manialinks\Nadeo\CMGame\OfficialThemes.
• 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:

POST https://live-services.trackmania.nadeo.live/api/token/club/103034/activity/1003588/edit

{
  "name": "My uploaded maps",
  "active": 1,
  "featured": 1,
  "folderId": 0,
  "mediaTheme": "mirage",
  "position": 0,
  "public": 0
}

Example response:

{
  "id": 1003588,
  "folderId": null,
  "public": false,
  "activityId": 1003588,
  "campaignId": 0,
  "name": "My uploaded maps",
  "clubId": 103034,
  "password": false,
  "featured": true,
  "activityType": "map-upload",
  "mediaUrlPngSmall": "",
  "mediaUrl": "",
  "latestEditorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "editionTimestamp": 1771560553,
  "mediaUrlPngLarge": "",
  "itemsCount": 0,
  "mediaTheme": "mirage",
  "position": 0,
  "targetActivityId": 1003588,
  "externalId": 0,
  "creatorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "mediaUrlDds": "",
  "active": true,
  "mediaUrlPngMedium": ""
}

If the club / activity does not exist or the player is not a member of the club, the response will contain an error:

[
  "clubMemberRole:error-notMember"
]

If the player does not have enough permissions in the club to edit activities, the response will contain an error:

[
  "clubMemberRole:error-notContentCreator"
]

If the folderID does not exist, the response will contain an error:

[
  "folder:error-notFound"
]

If the position is invalid, or the activity is already at that position, the response will contain an error:

[
  "position:error-wrongPosition"
]