# The coach's global settings for one exercise

`GET https://api.coach-platform.com/api/public/exercises/{exerciseId}/settings`

The coach's global settings for one exercise. An exercise the coach never configured returns the defaults (no notes, no video, mediaDisplay "gif", no alternatives).

- Resource: Exercises
- Authentication: API key in the `Authorization: Bearer cp_live_...` header
- HTML version: https://www.coach-platform.com/docs/api/reference/get-exercises-exercise-id-settings
- OpenAPI spec: https://www.coach-platform.com/openapi.json

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `exerciseId` | string | Yes | Exercise catalog id from GET /exercises. |

## Responses

| Status | Description |
|---|---|
| `200` OK | Successful response |
| `400` Bad Request |  |
| `401` Unauthorized |  |
| `403` Forbidden |  |
| `404` Not Found |  |
| `409` Conflict |  |
| `429` Too Many Requests |  |
| `500` Internal Server Error |  |

### 200 OK

Content type: `application/json`

| Field | Type | Description |
|---|---|---|
| `data` | object | The coach's own settings for one catalog exercise. They apply to every training plan and every trainee that uses the exercise. |
| `data.exerciseId` | string |   |
| `data.name` | string \| null |   |
| `data.nameHebrew` | string \| null |   |
| `data.isCustom` | boolean | True for an exercise the coach added to their own catalog. |
| `data.notes` | string \| null | Coach notes shown to trainees on this exercise. |
| `data.videoLink` | string \| null | Coach demonstration video URL. |
| `data.mediaDisplay` | string | How the exercise is shown to trainees: "gif" shows the GIF (tapping it opens the video), "thumbnail" shows the YouTube video thumbnail instead of the GIF. Allowed values: `gif`, `thumbnail`. |
| `data.trackRm1` | boolean | Track an estimated 1RM (Brzycki) for this exercise. |
| `data.isFavorite` | boolean | Marked as a coach favorite. |
| `data.alternativeExercises` | object[] | Default alternatives trainees may swap this exercise for, in every plan. |
| `data.alternativeExercises[].exerciseId` | string |   |
| `data.alternativeExercises[].name` | string \| null |   |
| `data.alternativeExercises[].nameHebrew` | string \| null |   |

Example:

```json
{
  "data": {
    "exerciseId": "<string>",
    "name": "<string>",
    "nameHebrew": "<string>",
    "isCustom": true,
    "notes": "<string>",
    "videoLink": "<string>",
    "mediaDisplay": "gif",
    "trackRm1": true,
    "isFavorite": true,
    "alternativeExercises": [
      {
        "exerciseId": "<string>",
        "name": "<string>",
        "nameHebrew": "<string>"
      }
    ]
  }
}
```

### Error responses 400, 401, 403, 404, 409, 429, 500

Content type: `application/json`

| Field | Type | Description |
|---|---|---|
| `error` | object |   |
| `error.code` | string |   |
| `error.message` | string |   |
| `error.fix` | string \| null |   |
| `error.details` | object \| null |   |
| `error.retryAfterMs` | number \| null |   |

Example:

```json
{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "fix": "<string>",
    "details": {},
    "retryAfterMs": 123
  }
}
```

## Examples

### cURL

```bash
curl --request GET \
  --url 'https://api.coach-platform.com/api/public/exercises/<exerciseId>/settings' \
  --header 'Authorization: Bearer cp_live_...'
```

### JavaScript (fetch)

```js
const response = await fetch('https://api.coach-platform.com/api/public/exercises/<exerciseId>/settings', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer cp_live_...',
  },
});

const data = await response.json();
```

## Related endpoints

- [Search the exercise catalog](https://www.coach-platform.com/docs/api/reference/get-exercises/index.md): `GET /api/public/exercises`. Search the exercises catalog (name, muscle group).
- [List the exercises the coach has configured](https://www.coach-platform.com/docs/api/reference/get-exercises-settings/index.md): `GET /api/public/exercises/settings`. List the exercises the coach has configured: coach notes, demonstration video, media display, 1RM tracking, favorite and the default alternatives trainees may swap to.
- [Change the coach's global settings for one exercise, the same…](https://www.coach-platform.com/docs/api/reference/patch-exercises-exercise-id-settings/index.md): `PATCH /api/public/exercises/{exerciseId}/settings`. Change the coach's global settings for one exercise, the same settings as the exercise library in the dashboard.
- Previous: [List the exercises the coach has configured](https://www.coach-platform.com/docs/api/reference/get-exercises-settings/index.md): `GET /api/public/exercises/settings`. List the exercises the coach has configured: coach notes, demonstration video, media display, 1RM tracking, favorite and the default alternatives trainees may swap to.
- Next: [Change the coach's global settings for one exercise, the same…](https://www.coach-platform.com/docs/api/reference/patch-exercises-exercise-id-settings/index.md): `PATCH /api/public/exercises/{exerciseId}/settings`. Change the coach's global settings for one exercise, the same settings as the exercise library in the dashboard.
