Intervals.icu API

https://intervals.icu/api/v1/docs/
Admin
Intervals.icu API is a RESTful API for managing athlete training data, workouts, wellness records,...
Tokens:139,835
Snippets:831
Trust Score:9.3
Update:12 hours ago
Show doc for...
Tokens:
Raw
### GET /api/v1/athlete/{id}/folders - Example Value (JSON)

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Library/listFolders

Example JSON response for the GET /api/v1/athlete/{id}/folders endpoint. Shows the structure of a folder object with nested workout details, owner information, and various fields like visibility, targets, and attachments.

```json
[
  {
    "athlete_id": "string",
    "id": 0,
    "type": "FOLDER",
    "name": "string",
    "description": "string",
    "children": [
      {
        "athlete_id": "string",
        "id": 0,
        "icu_training_load": 0,
        "name": "string",
        "description": "string",
        "type": "string",
        "indoor": true,
        "color": "string",
        "moving_time": 0,
        "updated": "2026-10-19T20:37:19.789Z",
        "joules": 0,
        "joules_above_ftp": 0,
        "workout_doc": {
          "additionalProp1": {},
          "additionalProp2": {},
          "additionalProp3": {}
        },
        "folder_id": 0,
        "day": 0,
        "days": 0,
        "plan_applied": "2026-10-19T20:37:19.789Z",
        "hide_from_athlete": true,
        "target": "AUTO",
        "targets": [
          "AUTO"
        ],
        "carbs_per_hour": 0,
        "tags": [
          "string"
        ],
        "attachments": [
          {
            "id": "string",
            "filename": "string",
            "mimetype": "string",
            "url": "string"
          }
        ],
        "time": "string",
        "sub_type": "NONE",
        "for_week": true,
        "distance": 0,
        "icu_intensity": 0
      }
    ],
    "visibility": "PRIVATE",
    "start_date_local": "string",
    "rollout_weeks": 0,
    "auto_rollout_day": 0,
    "read_only_workouts": true,
    "starting_ctl": 0,
    "starting_atl": 0,
    "activity_types": [
      "Ride"
    ],
    "num_workouts": 0,
    "duration_weeks": 0,
    "hours_per_week_min": 0,
    "hours_per_week_max": 0,
    "workout_targets": [
      "AUTO"
    ],
    "blurb": "string",
    "canEdit": true,
    "sharedWithCount": 0,
    "shareToken": "string",
    "owner": {
      "id": "string",
      "name": "string",
      "profile_medium": "string",
      "city": "string",
      "state": "string",
      "country": "string",
      "timezone": "string",
      "sex": "string",
      "bio": "string",
      "website": "string",
      "email": "string"
    }
  }
]
```

--------------------------------

### GET /api/v1/athlete/{id}/training-plan

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get the athlete's training plan.

```APIDOC
## GET /api/v1/athlete/{id}/training-plan

### Description
Get the athlete's training plan.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/training-plan

### Parameters
#### Path Parameters
- **id** (string) - Required - The athlete's ID.

```

--------------------------------

### GET /api/v1/athlete/{id}/activities/search

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/listActivityHRCurves

Search for activities by name or tag, returns full activities.

```APIDOC
## GET /api/v1/athlete/{id}/activities/search

### Description
Search for activities by name or tag, returns full activities.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/activities/search

### Parameters
#### Path Parameters
- **id** (integer) - Required - The athlete ID.

```

--------------------------------

### GET /api/v1/athlete/{id}/activities

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/listActivities

Retrieve a list of activities for the specified athlete. Returns an array of activity objects with detailed metrics.

```APIDOC
## GET /api/v1/athlete/{id}/activities

### Description
Retrieve a list of activities for the specified athlete. Returns an array of activity objects with detailed metrics.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/activities

### Parameters
#### Path Parameters
- **id** (integer) - Required - The athlete's ID.

### Response
#### Success Response (200)
Returns an array of activity objects. Each activity contains fields such as:
- **id** (integer) - Activity ID
- **start_date_local** (string) - Local start date
- **type** (string) - Activity type
- **name** (string) - Activity name
- **description** (string) - Activity description
- **distance** (number) - Distance in meters
- **moving_time** (integer) - Moving time in seconds
- **elapsed_time** (integer) - Elapsed time in seconds
- **total_elevation_gain** (number) - Total elevation gain in meters
- **average_speed** (number) - Average speed in meters per second
- **average_watts** (number) - Average power in watts
- **kilojoules** (number) - Energy in kilojoules
- **average_heartrate** (number) - Average heart rate in bpm
- **max_heartrate** (number) - Maximum heart rate in bpm
- **average_cadence** (number) - Average cadence
- **average_temp** (number) - Average temperature in Celsius
- **suffer_score** (number) - Suffer score
- **external_id** (string) - External ID
- **upload_id** (integer) - Upload ID
- **athlete_id** (integer) - Athlete ID
- **trainer** (boolean) - Whether it was on a trainer
- **commute** (boolean) - Whether it was a commute
- **manual** (boolean) - Whether it was manually entered
- **private** (boolean) - Whether it is private
- **flagged** (boolean) - Whether it is flagged
- **workout_type** (integer) - Workout type
- **uploaded_at** (string) - Upload timestamp
- **gear_id** (string) - Gear ID
- **device_name** (string) - Device name
- **embed_token** (string) - Embed token
- **pr_count** (integer) - Number of PRs
- **total_photo_count** (integer) - Total photo count
- **has_kudoed** (boolean) - Whether the athlete has kudoed
- **average_watts** (number) - Average power
- **kilojoules** (number) - Energy in kilojoules
- **average_heartrate** (number) - Average heart rate
- **max_heartrate** (number) - Maximum heart rate
- **average_cadence** (number) - Average cadence
- **average_temp** (number) - Average temperature
- **suffer_score** (number) - Suffer score
- **external_id** (string) - External ID
- **upload_id** (integer) - Upload ID
- **athlete_id** (integer) - Athlete ID
- **trainer** (boolean) - Trainer flag
- **commute** (boolean) - Commute flag
- **manual** (boolean) - Manual flag
- **private** (boolean) - Private flag
- **flagged** (boolean) - Flagged flag
- **workout_type** (integer) - Workout type
- **uploaded_at** (string) - Upload timestamp
- **gear_id** (string) - Gear ID
- **device_name** (string) - Device name
- **embed_token** (string) - Embed token
- **pr_count** (integer) - PR count
- **total_photo_count** (integer) - Total photo count
- **has_kudoed** (boolean) - Has kudoed flag
- **icu_* fields** - Various Intervals.icu specific metrics

#### Response Example
```json
[
  {
    "id": 0,
    "start_date_local": "string",
    "type": "string",
    "name": "string",
    "description": "string",
    "distance": 0,
    "moving_time": 0,
    "elapsed_time": 0,
    "total_elevation_gain": 0,
    "average_speed": 0,
    "average_watts": 0,
    "kilojoules": 0,
    "average_heartrate": 0,
    "max_heartrate": 0,
    "average_cadence": 0,
    "average_temp": 0,
    "suffer_score": 0,
    "external_id": "string",
    "upload_id": 0,
    "athlete_id": 0,
    "trainer": true,
    "commute": true,
    "manual": true,
    "private": true,
    "flagged": true,
    "workout_type": 0,
    "uploaded_at": "string",
    "gear_id": "string",
    "device_name": "string",
    "embed_token": "string",
    "pr_count": 0,
    "total_photo_count": 0,
    "has_kudoed": true
  }
]
```

```

--------------------------------

### Workout Object JSON Example

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Library/updateWorkout

Example JSON response for a workout object, showing all fields including athlete_id, id, icu_training_load, name, description, type, indoor, color, moving_time, updated, joules, joules_above_ftp, workout_doc, folder_id, day, days, plan_applied, hide_from_athlete, target, targets, carbs_per_hour, tags, attachments, time, sub_type, for_week, distance, and icu_intensity.

```json
{
  "athlete_id": "string",
  "id": 0,
  "icu_training_load": 0,
  "name": "string",
  "description": "string",
  "type": "string",
  "indoor": true,
  "color": "string",
  "moving_time": 0,
  "updated": "2026-10-19T20:37:16.322Z",
  "joules": 0,
  "joules_above_ftp": 0,
  "workout_doc": {
    "additionalProp1": {},
    "additionalProp2": {},
    "additionalProp3": {}
  },
  "folder_id": 0,
  "day": 0,
  "days": 0,
  "plan_applied": "2026-10-19T20:37:16.323Z",
  "hide_from_athlete": true,
  "target": "AUTO",
  "targets": [
    "AUTO"
  ],
  "carbs_per_hour": 0,
  "tags": [
    "string"
  ],
  "attachments": [
    {
      "id": "string",
      "filename": "string",
      "mimetype": "string",
      "url": "string"
    }
  ],
  "time": "string",
  "sub_type": "NONE",
  "for_week": true,
  "distance": 0,
  "icu_intensity": 0
}
```

--------------------------------

### Events list response example (JSON)

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Events/createMultipleEvents

Example JSON response for the Events list endpoint (GET /api/v1/athlete/{id}/events). Shows the schema for an event object with fields like id, start_date_local, icu_training_load, type, and more.

```json
[
  {
    "id": 0,
    "start_date_local": "string",
    "icu_training_load": 0,
    "icu_atl": 0,
    "icu_ctl": 0,
    "type": "string",
    "carbs_used": 0,
    "ss_p_max": 0,
    "ss_w_prime": 0,
    "ss_cp": 0,
    "calendar_id": 0,
    "uid": "string",
    "athlete_id": "string",
    "category": "WORKOUT",
    "end_date_local": "string",
    "name": "string",
    "description": "string",
    "indoor": true,
    "color": "string",
    "moving_time": 0,
    "icu_ftp": 0,
    "w_prime": 0,
    "p_max": 0,
    "atl_days": 0,
    "ctl_days": 0,
    "updated": "2026-10-19T20:37:26.826Z",
    "not_on_fitness_chart": true,
    "show_as_note": true,
    "show_on_ctl_line": true,
    "for_week": true,
    "target": "AUTO",
    "joules": 0,
    "joules_above_ftp": 0,
    "workout_doc": {
      "additionalProp1": {},
      "additionalProp2": {},
      "additionalProp3": {}
    },
    "push_errors": [
      {
        "service": "string",
        "message": "string",
        "date": "2026-10-19T20:37:26.826Z"
      }
    ],
    "athlete_cannot_edit": true,
    "hide_from_athlete": true,
    "structure_read_only": true,
    "created_by_id": "string",
    "shared_event_id": 0,
    "entered": true,
    "carbs_per_hour": 0,
    "sub_type": "NONE",
    "distance": 0,
    "tags": [
      "string"
    ],
    "attachments": [
      {
        "id": "string",
        "filename": "string",
        "mimetype": "string",
        "url": "string"
      }
    ],
    "oauth_client_id": 0,
    "external_id": "string",
    "load_target": 0,
    "time_target": 0,
    "distance_target": 0,
    "training_availability": "NORMAL",
    "max_training_time": 0,
    "can_train_sports": [
      "Ride"
    ],
    "plan_athlete_id": "string",
    "plan_folder_id": 0,
    "plan_workout_id": 0,
    "plan_applied": "2026-10-19T20:37:26.826Z",
    "icu_intensity": 0,
    "strain_score": 0
  }
]
```

--------------------------------

### POST /api/v1/download-workout{ext}

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Sports/deleteSettings

Convert a workout to .zwo (Zwift), .mrc, .erg or .fit.

```APIDOC
## POST /api/v1/download-workout{ext}

### Description
Convert a workout to .zwo (Zwift), .mrc, .erg or .fit.

### Method
POST

### Endpoint
/api/v1/download-workout{ext}

### Parameters
#### Path Parameters
- **ext** (string) - Required - File extension (e.g., .zwo, .mrc, .erg, .fit)

```

--------------------------------

### GET /api/v1/athlete/{id}/activities/search-full

Source: https://intervals.icu/api/v1/docs

Search for activities by name or tag, returns full activities. The search query is case insensitive for name search, or exact tag search if it starts with #.

```APIDOC
## GET /api/v1/athlete/{id}/activities/search-full

### Description
Search for activities by name or tag, returns full activities.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/activities/search-full

### Parameters
#### Path Parameters
- **id** (string) - Required - The athlete ID

#### Query Parameters
- **q** (string) - Required - Search query, case insensitive name search or exact tag search if it starts with #
- **limit** (integer) - Optional - Maximum number of results to return

### Response
#### Success Response (200)
Returns an array of Activity objects.

```

--------------------------------

### POST /api/v1/athlete/{id}/events/{eventId}/mark-done

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Creates a manual activity to match a planned workout.

```APIDOC
## POST /api/v1/athlete/{id}/events/{eventId}/mark-done

### Description
Create a manual activity to match a planned workout.

### Method
POST

### Endpoint
/api/v1/athlete/{id}/events/{eventId}/mark-done

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **eventId** (string) - Required - Event ID

### Response
#### Success Response (200)
- No response body specified

```

--------------------------------

### GET /api/v1/activity/{id}

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get an activity.

```APIDOC
## GET /api/v1/activity/{id}

### Description
Get an activity.

### Method
GET

### Endpoint
/api/v1/activity/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - Activity ID

```

--------------------------------

### POST /api/v1/athlete/{id}/activities/manual

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Creates a single manual activity for the athlete.

```APIDOC
## POST /api/v1/athlete/{id}/activities/manual

### Description
Create a manual activity.

### Method
POST

### Endpoint
/api/v1/athlete/{id}/activities/manual

### Parameters
#### Path Parameters
- **id** (string) - Required - The athlete's ID.

#### Request Body
A manual activity object with fields such as `name`, `type`, `start_date`, `end_date`, `distance`, `duration`, etc.

### Response
#### Success Response (200)
The created activity object.

#### Error Response
- **400** - Invalid request body.
- **401** - Unauthorized.
```

--------------------------------

### GET /api/v1/activity/{id}/segments

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get activity segments.

```APIDOC
## GET /api/v1/activity/{id}/segments

### Description
Get activity segments.

### Method
GET

### Endpoint
/api/v1/activity/{id}/segments

### Parameters
#### Path Parameters
- **id** (integer) - Required - The activity ID.

### Response
#### Success Response (200)
Returns the activity segments.

```

--------------------------------

### GET /api/v1/activity/{id}/intervals

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get activity intervals.

```APIDOC
## GET /api/v1/activity/{id}/intervals

### Description
Get activity intervals.

### Method
GET

### Endpoint
/api/v1/activity/{id}/intervals

### Parameters
#### Path Parameters
- **id** (string) - Required - Activity ID

```

--------------------------------

### POST /api/v1/athlete/{id}/activities/manual/bulk

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Creates multiple manual activities with upsert on external_id.

```APIDOC
## POST /api/v1/athlete/{id}/activities/manual/bulk

### Description
Create multiple manual activities with upsert on external_id.

### Method
POST

### Endpoint
/api/v1/athlete/{id}/activities/manual/bulk

### Parameters
#### Path Parameters
- **id** (string) - Required - The athlete's ID.

#### Request Body
An array of manual activity objects. Each object may include fields such as `external_id`, `name`, `type`, `start_date`, `end_date`, etc.

### Response
#### Success Response (200)
An array of created/updated activities.

#### Error Response
- **400** - Invalid request body.
- **401** - Unauthorized.
```

--------------------------------

### GET /api/v1/athlete/{id}

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get the athlete with sportSettings and custom_items.

```APIDOC
## GET /api/v1/athlete/{id}

### Description
Get the athlete with sportSettings and custom_items.

### Method
GET

### Endpoint
/api/v1/athlete/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The athlete's ID.

```

--------------------------------

### Example Value for Custom Item Response

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Custom%20Items/getCustomItem

Shown as the 'Example Value' for a 200 OK response of a custom item endpoint. It is a JSON object with fields like id, athlete_id, type, visibility, name, description, image, content, usage_count, index, hide_script, hidden_by_id, updated, from_athlete, and from_id.

```json
{
  "id": 0,
  "athlete_id": "string",
  "type": "FITNESS_CHART",
  "visibility": "PRIVATE",
  "name": "string",
  "description": "string",
  "image": "string",
  "content": {
    "additionalProp1": {},
    "additionalProp2": {},
    "additionalProp3": {}
  },
  "usage_count": 0,
  "index": 0,
  "hide_script": true,
  "hidden_by_id": "string",
  "updated": "2026-10-19T20:37:26.774Z",
  "from_athlete": {
    "id": "string",
    "name": "string",
    "profile_medium": "string",
    "city": "string",
    "state": "string",
    "country": "string",
    "timezone": "string",
    "sex": "string",
    "bio": "string",
    "website": "string",
    "email": "string"
  },
  "from_id": 0
}
```

--------------------------------

### POST /api/v1/activity/{id}/file

Source: https://intervals.icu/api/v1/docs

Replace the original activity file and reprocess the activity. Name, description, type, gear, tags, zones, RPE etc. are kept. If the file has not changed nothing is done and the response is still 200 but with activity null, so check for that. Supports .fit, .tcx and .gpx files, optionally gzipped (.gz), or a .zip containing exactly one of these.

```APIDOC
## POST /api/v1/activity/{id}/file

### Description
Replace the original activity file and reprocess the activity. Name, description, type, gear, tags, zones, RPE etc. are kept. If the file has not changed nothing is done and the response is still 200 but with activity null, so check for that. Supports .fit, .tcx and .gpx files, optionally gzipped (.gz), or a .zip containing exactly one of these.

### Method
POST

### Endpoint
/api/v1/activity/{id}/file

### Parameters
#### Path Parameters
- **id** (string) - Required - Activity ID

### Response
#### Success Response (200)
- Returns the reprocessed activity, or null if the file has not changed
```

--------------------------------

### GET /api/v1/activity/{id}/interval-stats

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Library/applyCurrentPlanChanges

Get activity interval stats.

```APIDOC
## GET /api/v1/activity/{id}/interval-stats

### Description
Get activity interval stats.

### Method
GET

### Endpoint
/api/v1/activity/{id}/interval-stats

### Parameters
#### Path Parameters
- **id** (string) - Required - The activity ID.

```

--------------------------------

### GET /api/v1/activity/{id}/map

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get activity map data.

```APIDOC
## GET /api/v1/activity/{id}/map

### Description
Get activity map data.

### Method
GET

### Endpoint
/api/v1/activity/{id}/map

### Parameters
#### Path Parameters
- **id** (integer) - Required - The activity ID.

### Response
#### Success Response (200)
Returns map data for the activity.

```

--------------------------------

### POST /api/v1/activity/{id}/file

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Replaces the original activity file and reprocesses the activity.

```APIDOC
## POST /api/v1/activity/{id}/file

### Description
Replace the original activity file and reprocess the activity.

### Method
POST

### Endpoint
/api/v1/activity/{id}/file

### Parameters
#### Path Parameters
- **id** (string) - Required - The activity ID.

#### Request Body
Multipart/form-data containing the new activity file.

### Response
#### Success Response (200)
The updated activity object.

#### Error Response
- **400** - Invalid file.
- **404** - Activity not found.
- **401** - Unauthorized.
```

--------------------------------

### GET /api/v1/activity/{id}/pace-histogram

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get activity pace histogram.

```APIDOC
## GET /api/v1/activity/{id}/pace-histogram

### Description
Get activity pace histogram.

### Method
GET

### Endpoint
/api/v1/activity/{id}/pace-histogram

### Parameters
#### Path Parameters
- **id** (integer) - Required - The activity ID.

### Response
#### Success Response (200)
Returns the pace histogram for the activity.

```

--------------------------------

### Library

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/getGapHistogram

Endpoints for managing workout library, folders, and plans.

```APIDOC
## GET /api/v1/athlete/{id}/workouts/{workoutId}

### Description
Get a workout.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/workouts/{workoutId}

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **workoutId** (string) - Required - Workout ID

### Response
#### Success Response (200)
No response body specified.

---

## PUT /api/v1/athlete/{id}/workouts/{workoutId}

### Description
Update a workout.

### Method
PUT

### Endpoint
/api/v1/athlete/{id}/workouts/{workoutId}

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **workoutId** (string) - Required - Workout ID

### Response
#### Success Response (200)
No response body specified.

---

## DELETE /api/v1/athlete/{id}/workouts/{workoutId}

### Description
Delete a workout (and optionally others added at the same time if the workout is on a plan).

### Method
DELETE

### Endpoint
/api/v1/athlete/{id}/workouts/{workoutId}

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **workoutId** (string) - Required - Workout ID

### Response
#### Success Response (200)
No response body specified.

---

## PUT /api/v1/athlete/{id}/folders/{folderId}/workouts

### Description
Update a range of workouts on a plan. Currently only hide_from_athlete can be changed.

### Method
PUT

### Endpoint
/api/v1/athlete/{id}/folders/{folderId}/workouts

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **folderId** (string) - Required - Folder ID

### Response
#### Success Response (200)
No response body specified.

---

## GET /api/v1/athlete/{id}/folders/{folderId}/shared-with

### Description
List athletes that the folder or plan has been shared with.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/folders/{folderId}/shared-with

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **folderId** (string) - Required - Folder ID

### Response
#### Success Response (200)
No response body specified.

---

## PUT /api/v1/athlete/{id}/folders/{folderId}/shared-with

### Description
Add/remove athletes from the share list for the folder.

### Method
PUT

### Endpoint
/api/v1/athlete/{id}/folders/{folderId}/shared-with

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **folderId** (string) - Required - Folder ID

### Response
#### Success Response (200)
No response body specified.

---

## PUT /api/v1/athlete/{id}/folders/{folderId}

### Description
Update a workout folder or plan.

### Method
PUT

### Endpoint
/api/v1/athlete/{id}/folders/{folderId}

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **folderId** (string) - Required - Folder ID

### Response
#### Success Response (200)
No response body specified.

---

## DELETE /api/v1/athlete/{id}/folders/{folderId}

### Description
Delete a workout folder or plan including all workouts.

### Method
DELETE

### Endpoint
/api/v1/athlete/{id}/folders/{folderId}

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **folderId** (string) - Required - Folder ID

### Response
#### Success Response (200)
No response body specified.

---

## PUT /api/v1/athlete/{id}/apply-plan-changes

### Description
Apply any changes from the athlete's current plan to the athlete's calendar.

### Method
PUT

### Endpoint
/api/v1/athlete/{id}/apply-plan-changes

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID

### Response
#### Success Response (200)
No response body specified.

---

## POST /api/v1/download-workout{ext}

### Description
Convert a workout to .zwo (Zwift), .mrc, .erg or .fit.

### Method
POST

### Endpoint
/api/v1/download-workout{ext}

### Parameters
#### Path Parameters
- **ext** (string) - Required - File extension (e.g., .zwo, .mrc, .erg, .fit)

### Response
#### Success Response (200)
No response body specified.

---

## POST /api/v1/athlete/{id}/workouts/bulk

### Description
Create multiple new workouts in a folder or plan in the athlete's workout library.

### Method
POST

### Endpoint
/api/v1/athlete/{id}/workouts/bulk

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID

### Response
#### Success Response (200)
No response body specified.

---

## GET /api/v1/athlete/{id}/workouts

### Description
List all the workouts in the athlete's library.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/workouts

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID

### Response
#### Success Response (200)
No response body specified.

---

## POST /api/v1/athlete/{id}/workouts

### Description
Create a new workout in a folder or plan in the athlete's workout library.

### Method
POST

### Endpoint
/api/v1/athlete/{id}/workouts

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID

### Response
#### Success Response (200)
No response body specified.

---

## POST /api/v1/athlete/{id}/folders/{folderId}/import-workout

### Description
Create new workout from .zwo, .mrc, .erg or .fit file in a folder.

### Method
POST

### Endpoint
/api/v1/athlete/{id}/folders/{folderId}/import-workout

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID
- **folderId** (string) - Required - Folder ID

### Response
#### Success Response (200)
No response body specified.

---

## GET /api/v1/athlete/{id}/folders

### Description
List all the athlete's folders, plans and workouts.

### Method
GET

### Endpoint
/api/v1/athlete/{id}/folders

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID

### Response
#### Success Response (200)
No response body specified.

---

## POST /api/v1/athlete/{id}/folders

### Description
Create a new workout folder or plan.

### Method
POST

### Endpoint
/api/v1/athlete/{id}/folders

### Parameters
#### Path Parameters
- **id** (string) - Required - Athlete ID

### Response
#### Success Response (200)
No response body specified.
```

--------------------------------

### GET /api/v1/activity/{id}/power-histogram

Source: https://intervals.icu/api/v1/docs/swagger-ui/index.html#/Activities/updateActivity

Get activity power histogram.

```APIDOC
## GET /api/v1/activity/{id}/power-histogram

### Description
Get activity power histogram.

### Method
GET

### Endpoint
/api/v1/activity/{id}/power-histogram

### Parameters
#### Path Parameters
- **id** (integer) - Required - The activity ID.

### Response
#### Success Response (200)
Returns the power histogram for the activity.

```
Tokens:
Raw