ActivitiesApi

All URIs are relative to https://www.strava.com/api/v3

MethodHTTP requestDescription
create_activityPOST /activitiesCreate an Activity
getactivityby_idGET /activities/{id}Get Activity
getcommentsbyactivityidGET /activities/{id}/commentsList Activity Comments
getkudoersbyactivityidGET /activities/{id}/kudosList Activity Kudoers
getlapsbyactivityidGET /activities/{id}/lapsList Activity Laps
getloggedinathleteactivitiesGET /athlete/activitiesList Athlete Activities
getzonesbyactivityidGET /activities/{id}/zonesGet Activity Zones
updateactivityby_idPUT /activities/{id}Update Activity

create_activity

create_activity(api::ActivitiesApi, name::String, `sporttype::String,startdatelocal::ZonedDateTime,elapsedtime::Int64;type=nothing,description=nothing,distance=nothing,trainer=nothing,commute=nothing, _mediaType=nothing) ->DetailedActivity,OpenAPI.Clients.ApiResponse<br/>createactivity(_api::ActivitiesApi, response_stream::Channel,name::String,sporttype::String,startdatelocal::ZonedDateTime,elapsedtime::Int64;type=nothing,description=nothing,distance=nothing,trainer=nothing,commute=nothing, _mediaType=nothing) ->Channel{DetailedActivity},OpenAPI.Clients.ApiResponse`

Create an Activity

Creates a manual activity for an athlete, requires activity:write scope.

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context
nameStringThe name of the activity.
sport_typeStringSport type of activity. For example - Run, MountainBikeRide, Ride, etc.
start_date_localZonedDateTimeISO 8601 formatted date time.
elapsed_timeInt64In seconds.

Optional Parameters

NameTypeDescriptionNotes
typeStringType of activity. For example - Run, Ride etc.[default to nothing]
descriptionStringDescription of the activity.[default to nothing]
distanceFloat32In meters.[default to nothing]
trainerInt64Set to 1 to mark as a trainer activity.[default to nothing]
commuteInt64Set to 1 to mark as commute.[default to nothing]

Return type

DetailedActivity

Authorization

strava_oauth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getactivityby_id

get_activity_by_id(api::ActivitiesApi, id::Int64; `includeallefforts=nothing, _mediaType=nothing) ->DetailedActivity,OpenAPI.Clients.ApiResponse<br/>getactivitybyid(_api::ActivitiesApi, response_stream::Channel,id::Int64;includeallefforts=nothing, _mediaType=nothing) ->Channel{DetailedActivity},OpenAPI.Clients.ApiResponse`

Get Activity

Returns the given activity that is owned by the authenticated athlete. Requires activity:read for Everyone and Followers activities. Requires activity:read_all for Only Me activities. We strongly encourage you to display the appropriate attribution that identifies Garmin as the data source and the device name in your application. Please see example below from VeloViewer (that provides an attribution for a Garmin Forerunner device). Attribution

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context
idInt64The identifier of the activity.

Optional Parameters

NameTypeDescriptionNotes
include_all_effortsBoolTo include all segments efforts.[default to nothing]

Return type

DetailedActivity

Authorization

strava_oauth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getcommentsbyactivityid

get_comments_by_activity_id(api::ActivitiesApi, id::Int64; page=nothing, `perpage=nothing,pagesize=nothing,aftercursor=nothing, _mediaType=nothing) ->Vector{Comment},OpenAPI.Clients.ApiResponse<br/>getcommentsbyactivityid(_api::ActivitiesApi, response_stream::Channel,id::Int64;page=nothing,perpage=nothing,pagesize=nothing,after_cursor=nothing, _mediaType=nothing) ->Channel{Vector{Comment}},OpenAPI.Clients.ApiResponse`

List Activity Comments

Returns the comments on the given activity. Requires activity:read for Everyone and Followers activities. Requires activity:read_all for Only Me activities.

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context
idInt64The identifier of the activity.

Optional Parameters

NameTypeDescriptionNotes
pageInt64Deprecated. Prefer to use after_cursor.[default to nothing]
per_pageInt64Deprecated. Prefer to use page_size.[default to 30]
page_sizeInt64Number of items per page. Defaults to 30.[default to 30]
after_cursorStringCursor of the last item in the previous page of results, used to request the subsequent page of results. When omitted, the first page of results is fetched.[default to nothing]

Return type

Vector{Comment}

Authorization

strava_oauth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getkudoersbyactivityid

get_kudoers_by_activity_id(api::ActivitiesApi, id::Int64; page=nothing, `perpage=nothing, _mediaType=nothing) ->Vector{SummaryAthlete},OpenAPI.Clients.ApiResponse<br/>getkudoersbyactivityid(_api::ActivitiesApi, response_stream::Channel,id::Int64;page=nothing,per_page=nothing, _mediaType=nothing) ->Channel{Vector{SummaryAthlete}},OpenAPI.Clients.ApiResponse`

List Activity Kudoers

Returns the athletes who kudoed an activity identified by an identifier. Requires activity:read for Everyone and Followers activities. Requires activity:read_all for Only Me activities.

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context
idInt64The identifier of the activity.

Optional Parameters

NameTypeDescriptionNotes
pageInt64Page number. Defaults to 1.[default to nothing]
per_pageInt64Number of items per page. Defaults to 30.[default to 30]

Return type

Vector{SummaryAthlete}

Authorization

strava_oauth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getlapsbyactivityid

get_laps_by_activity_id(api::ActivitiesApi, id::Int64; _mediaType=nothing) -> Vector{Lap}, OpenAPI.Clients.ApiResponse <br/> `getlapsbyactivityid`(api::ActivitiesApi, response_stream::Channel, id::Int64; _mediaType=nothing) -> Channel{ Vector{Lap} }, OpenAPI.Clients.ApiResponse

List Activity Laps

Returns the laps of an activity identified by an identifier. Requires activity:read for Everyone and Followers activities. Requires activity:read_all for Only Me activities.

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context
idInt64The identifier of the activity.

Return type

Vector{Lap}

Authorization

strava_oauth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getloggedinathleteactivities

get_logged_in_athlete_activities(api::ActivitiesApi; before=nothing, after=nothing, page=nothing, `perpage=nothing, _mediaType=nothing) ->Vector{SummaryActivity},OpenAPI.Clients.ApiResponse<br/>getloggedinathleteactivities(_api::ActivitiesApi, response_stream::Channel;before=nothing,after=nothing,page=nothing,per_page=nothing, _mediaType=nothing) ->Channel{Vector{SummaryActivity}},OpenAPI.Clients.ApiResponse`

List Athlete Activities

Returns the activities of an athlete for a specific identifier. Requires activity:read. Only Me activities will be filtered out unless requested by a token with activity:read_all.

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context

Optional Parameters

NameTypeDescriptionNotes
beforeInt64An epoch timestamp to use for filtering activities that have taken place before a certain time.[default to nothing]
afterInt64An epoch timestamp to use for filtering activities that have taken place after a certain time.[default to nothing]
pageInt64Page number. Defaults to 1.[default to nothing]
per_pageInt64Number of items per page. Defaults to 30.[default to 30]

Return type

Vector{SummaryActivity}

Authorization

strava_oauth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getzonesbyactivityid

get_zones_by_activity_id(api::ActivitiesApi, id::Int64; _mediaType=nothing) -> Vector{ActivityZone}, OpenAPI.Clients.ApiResponse <br/> `getzonesbyactivityid`(api::ActivitiesApi, response_stream::Channel, id::Int64; _mediaType=nothing) -> Channel{ Vector{ActivityZone} }, OpenAPI.Clients.ApiResponse

Get Activity Zones

Summit Feature. Returns the zones of a given activity. Requires activity:read for Everyone and Followers activities. Requires activity:read_all for Only Me activities.

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context
idInt64The identifier of the activity.

Return type

Vector{ActivityZone}

Authorization

strava_oauth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

updateactivityby_id

update_activity_by_id(api::ActivitiesApi, id::Int64; body=nothing, _mediaType=nothing) -> DetailedActivity, OpenAPI.Clients.ApiResponse <br/> `updateactivitybyid(_api::ActivitiesApi, response_stream::Channel,id::Int64;body=nothing, _mediaType=nothing) ->Channel{DetailedActivity},OpenAPI.Clients.ApiResponse`

Update Activity

Updates the given activity that is owned by the authenticated athlete. Requires activity:write. Also requires activity:read_all in order to update Only Me activities

Required Parameters

NameTypeDescriptionNotes
_apiActivitiesApiAPI context
idInt64The identifier of the activity.

Optional Parameters

NameTypeDescriptionNotes
bodyUpdatableActivity

Return type

DetailedActivity

Authorization

strava_oauth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]