CAcatapultsports
Athletes

Update an Athlete

Changed on

This API will update and return athlete details for a single athlete.

put/athletes/{id}

Request

  • Base URL
    https://connect-au.catapultsports.com/api/v6
  • Auth
    HTTP bearer

Path parameters

idstring required

Athlete Id

Request body

first_namestring
last_namestring
genderstring
position_idstring
team_idstring
jerseystring
nicknamestring
heightinteger
weightinteger
date_of_birthinteger
date_of_birth_datestring
velocity_maxnumber
acceleration_maxnumber
heart_rate_maxnumber
player_load_maxnumber
mechanical_power_maxnumber

Maximum mechanical power in W/kg. Changing it rescales the athlete's relative Mechanical Power band sets. Ignored unless the account has the MultidirectionalLoad.Released module.

imagestring
iconstring
stroke_colourstring
fill_colourstring
trail_colour_startstring
trail_colour_endstring

Example request

{
  "first_name": "Jock",
  "last_name": "Rose",
  "gender": "Male",
  "position_id": "da0412b7-d274-11e4-b293-22000afc007c",
  "team_id": "03ca53e1-e1b8-4d01-acde-db97fd3feffc",
  "jersey": "02",
  "nickname": "Rosey",
  "height": 185,
  "weight": 97,
  "date_of_birth": 520524002,
  "date_of_birth_date": "1970-01-01",
  "velocity_max": 10,
  "acceleration_max": 9,
  "heart_rate_max": 222,
  "player_load_max": 10,
  "mechanical_power_max": 45,
  "image": "example.png",
  "icon": "example.ico",
  "stroke_colour": "#ffffff",
  "fill_colour": "#fffffd",
  "trail_colour_start": "#000008",
  "trail_colour_end": "#00000F"
}

Response

Updated Athlete Details

idstring required
first_namestring required
last_namestring required
genderstring nullable required
jerseystring
nicknamestring
heightnumber
weightnumber
date_of_birthinteger
date_of_birth_datestring required
velocity_maxnumber
acceleration_maxnumber
heart_rate_maxnumber
player_load_maxnumber
mechanical_power_maxnumber

Maximum mechanical power in W/kg. Thresholds the relative Mechanical Power band sets. Only meaningful for accounts with the MultidirectionalLoad.Released module; defaults to 45.

imagestring
image_urlstring
iconstring
stroke_colourstring
fill_colourstring
trail_colour_startstring
trail_colour_endstring
is_syncedinteger
is_deletedinteger
is_demoboolean
created_atstring
modified_atstring
tag_liststring[]
current_team_idstring
max_player_load_per_minuteinteger
positionstring required
position_idstring
position_namestring required

Example response

{
  "created_at": "2023-10-31 23:59:59",
  "modified_at": "2023-10-31 23:59:59"
}

Changes

  • 4f0d7082f399Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status