All URIs are relative to https://www.strava.com/api/v3
| Method | HTTP request | Description |
|---|---|---|
| CreateActivity | Post /activities | Create an Activity |
| GetActivityById | Get /activities/{id} | Get Activity |
| GetCommentsByActivityId | Get /activities/{id}/comments | List Activity Comments |
| GetKudoersByActivityId | Get /activities/{id}/kudos | List Activity Kudoers |
| GetLapsByActivityId | Get /activities/{id}/laps | List Activity Laps |
| GetLoggedInAthleteActivities | Get /athlete/activities | List Athlete Activities |
| GetZonesByActivityId | Get /activities/{id}/zones | Get Activity Zones |
| UpdateActivityById | Put /activities/{id} | Update Activity |
DetailedActivity CreateActivity(ctx, name, type_, startDateLocal, elapsedTime, optional) Create an Activity
Creates a manual activity for an athlete, requires activity:write scope.
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| name | string | The name of the activity. | |
| type_ | string | Type of activity. For example - Run, Ride etc. | |
| startDateLocal | interface{} | ISO 8601 formatted date time. | |
| elapsedTime | int32 | In seconds. | |
| optional | *CreateActivityOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a CreateActivityOpts struct
| Name | Type | Description | Notes |
|---|
description | optional.String| Description of the activity. | distance | optional.Float32| In meters. | trainer | optional.Int32| Set to 1 to mark as a trainer activity. | commute | optional.Int32| Set to 1 to mark as commute. |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DetailedActivity GetActivityById(ctx, id, optional) 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.
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | int64 | The identifier of the activity. | |
| optional | *GetActivityByIdOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a GetActivityByIdOpts struct
| Name | Type | Description | Notes |
|---|
includeAllEfforts | optional.Bool| To include all segments efforts. |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
[]Comment GetCommentsByActivityId(ctx, id, optional) 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.
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | int64 | The identifier of the activity. | |
| optional | *GetCommentsByActivityIdOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a GetCommentsByActivityIdOpts struct
| Name | Type | Description | Notes |
|---|
page | optional.Int32| Page number. | perPage | optional.Int32| Number of items per page. Defaults to 30. | [default to 30]
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
[]SummaryAthlete GetKudoersByActivityId(ctx, id, optional) 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.
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | int32 | The identifier of the activity. | |
| optional | *GetKudoersByActivityIdOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a GetKudoersByActivityIdOpts struct
| Name | Type | Description | Notes |
|---|
page | optional.Int32| Page number. | perPage | optional.Int32| Number of items per page. Defaults to 30. | [default to 30]
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
[]Lap GetLapsByActivityId(ctx, id) 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.
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | int64 | The identifier of the activity. |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
[]SummaryActivity GetLoggedInAthleteActivities(ctx, optional) 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.
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| optional | *GetLoggedInAthleteActivitiesOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a GetLoggedInAthleteActivitiesOpts struct
| Name | Type | Description | Notes |
|---|---|---|---|
| before | optional.Int32 | An epoch timestamp to use for filtering activities that have taken place before a certain time. | |
| after | optional.Int32 | An epoch timestamp to use for filtering activities that have taken place after a certain time. | |
| page | optional.Int32 | Page number. | |
| perPage | optional.Int32 | Number of items per page. Defaults to 30. | [default to 30] |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
[]ActivityZone GetZonesByActivityId(ctx, id) 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.
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | int32 | The identifier of the activity. |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DetailedActivity UpdateActivityById(ctx, id, optional) 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
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | int64 | The identifier of the activity. | |
| optional | *UpdateActivityByIdOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a UpdateActivityByIdOpts struct
| Name | Type | Description | Notes |
|---|
body | optional.Interface of UpdatableActivity| |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]