# Coach Platform API reference

> The API is available to Coach account holders and the people who build their automations. Create an API key in your Coach account under Settings → מפתחים ואוטומציות (Developers and automations), or connect an MCP client with one-click OAuth.

The reference covers 97 endpoints across 18 resources.

- Base URL: https://api.coach-platform.com
- Authentication: `Authorization: Bearer cp_live_...` (6 public endpoints need no key)
- OpenAPI spec: https://www.coach-platform.com/openapi.json
- Interactive explorer: https://www.coach-platform.com/docs/api
- MCP server (API key or one-click OAuth): https://api.coach-platform.com/api/public/mcp
- Agent guide served by the API: https://api.coach-platform.com/api/public/llms.txt
- Overview in Hebrew: https://www.coach-platform.com/developers

## Discovery

Unauthenticated discovery and reference endpoints.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/health` | [Check API health](https://www.coach-platform.com/docs/api/reference/get-health/index.md) |
| `GET` | `/api/public/catalog` | [Get the catalog of scopes and webhook events](https://www.coach-platform.com/docs/api/reference/get-catalog/index.md) |
| `GET` | `/api/public/llms.txt` | [Get the AI agent guide (llms.txt)](https://www.coach-platform.com/docs/api/reference/get-llms-txt/index.md) |
| `GET` | `/api/public/errors` | [List error codes](https://www.coach-platform.com/docs/api/reference/get-errors/index.md) |
| `GET` | `/api/public/changelog` | [Get the API changelog](https://www.coach-platform.com/docs/api/reference/get-changelog/index.md) |
| `GET` | `/api/public/limits` | [Get API limits](https://www.coach-platform.com/docs/api/reference/get-limits/index.md) |

## Coach

The authenticated coach profile.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/me` | [Get the authenticated coach profile](https://www.coach-platform.com/docs/api/reference/get-me/index.md) |

## Trainees

Create, read, and update trainees.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/trainees` | [List trainees](https://www.coach-platform.com/docs/api/reference/get-trainees/index.md) |
| `POST` | `/api/public/trainees` | [Create a trainee](https://www.coach-platform.com/docs/api/reference/post-trainees/index.md) |
| `POST` | `/api/public/trainees/pending` | [Approve or reject pending trainees](https://www.coach-platform.com/docs/api/reference/post-trainees-pending/index.md) |
| `GET` | `/api/public/trainees/{traineeId}` | [Get a trainee](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id/index.md) |
| `PATCH` | `/api/public/trainees/{traineeId}` | [Update a trainee](https://www.coach-platform.com/docs/api/reference/patch-trainees-trainee-id/index.md) |
| `DELETE` | `/api/public/trainees/{traineeId}` | [Remove a trainee](https://www.coach-platform.com/docs/api/reference/delete-trainees-trainee-id/index.md) |
| `POST` | `/api/public/trainees/{traineeId}/restore` | [Restore an archived trainee](https://www.coach-platform.com/docs/api/reference/post-trainees-trainee-id-restore/index.md) |
| `POST` | `/api/public/trainees/{traineeId}/send-credentials` | [Send access details to a trainee](https://www.coach-platform.com/docs/api/reference/post-trainees-trainee-id-send-credentials/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/weekly-activity` | [Get a trainee's weekly activity](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-weekly-activity/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/measurements` | [Get a trainee's body measurements](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-measurements/index.md) |
| `POST` | `/api/public/trainees/{traineeId}/body-metrics` | [Record a weigh-in](https://www.coach-platform.com/docs/api/reference/post-trainees-trainee-id-body-metrics/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/photos` | [List a trainee's progress photos](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-photos/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/personal-records` | [List a trainee's personal records](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-personal-records/index.md) |

## Labels

Trainee labels.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/labels` | [List labels](https://www.coach-platform.com/docs/api/reference/get-labels/index.md) |
| `POST` | `/api/public/trainees/{traineeId}/labels` | [Add labels to a trainee](https://www.coach-platform.com/docs/api/reference/post-trainees-trainee-id-labels/index.md) |
| `DELETE` | `/api/public/trainees/{traineeId}/labels/{labelId}` | [Remove a label from a trainee](https://www.coach-platform.com/docs/api/reference/delete-trainees-trainee-id-labels-label-id/index.md) |
| `PATCH` | `/api/public/labels/{labelId}` | [Update a label](https://www.coach-platform.com/docs/api/reference/patch-labels-label-id/index.md) |
| `DELETE` | `/api/public/labels/{labelId}` | [Delete a label](https://www.coach-platform.com/docs/api/reference/delete-labels-label-id/index.md) |

## Escorts

Coaching periods linking a coach and a trainee.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/escorts/{escortId}` | [Get a coaching period](https://www.coach-platform.com/docs/api/reference/get-escorts-escort-id/index.md) |
| `PATCH` | `/api/public/escorts/{escortId}` | [Update a coaching period](https://www.coach-platform.com/docs/api/reference/patch-escorts-escort-id/index.md) |
| `DELETE` | `/api/public/escorts/{escortId}` | [Cancel a coaching period](https://www.coach-platform.com/docs/api/reference/delete-escorts-escort-id/index.md) |
| `POST` | `/api/public/escorts` | [Start a coaching period](https://www.coach-platform.com/docs/api/reference/post-escorts/index.md) |

## Training Plans

Workout plans and their workout days.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/training-plans` | [List training plans](https://www.coach-platform.com/docs/api/reference/get-training-plans/index.md) |
| `POST` | `/api/public/training-plans` | [Create a training plan](https://www.coach-platform.com/docs/api/reference/post-training-plans/index.md) |
| `GET` | `/api/public/training-plans/{planId}` | [Get a training plan](https://www.coach-platform.com/docs/api/reference/get-training-plans-plan-id/index.md) |
| `PATCH` | `/api/public/training-plans/{planId}` | [Update a training plan](https://www.coach-platform.com/docs/api/reference/patch-training-plans-plan-id/index.md) |
| `DELETE` | `/api/public/training-plans/{planId}` | [Delete a training plan](https://www.coach-platform.com/docs/api/reference/delete-training-plans-plan-id/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/active-training-plan` | [Get a trainee's active training plan](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-active-training-plan/index.md) |
| `POST` | `/api/public/training-plans/{planId}/duplicate` | [Duplicate a training plan](https://www.coach-platform.com/docs/api/reference/post-training-plans-plan-id-duplicate/index.md) |

## Workout Logs

Completed workout logs.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/workout-logs` | [List workout logs](https://www.coach-platform.com/docs/api/reference/get-workout-logs/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/exercise-notes` | [List a trainee's exercise notes](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-exercise-notes/index.md) |

## Exercises

The exercise catalog.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/exercises` | [Search the exercise catalog](https://www.coach-platform.com/docs/api/reference/get-exercises/index.md) |

## Nutrition Menus

Nutrition menus and meals.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/trainees/{traineeId}/nutrition-log` | [Get a trainee's daily nutrition log](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-nutrition-log/index.md) |
| `GET` | `/api/public/nutrition-menus` | [List nutrition menus](https://www.coach-platform.com/docs/api/reference/get-nutrition-menus/index.md) |
| `POST` | `/api/public/nutrition-menus` | [Create a nutrition menu](https://www.coach-platform.com/docs/api/reference/post-nutrition-menus/index.md) |
| `GET` | `/api/public/nutrition-menus/{menuId}` | [Get a nutrition menu](https://www.coach-platform.com/docs/api/reference/get-nutrition-menus-menu-id/index.md) |
| `PATCH` | `/api/public/nutrition-menus/{menuId}` | [Update a nutrition menu](https://www.coach-platform.com/docs/api/reference/patch-nutrition-menus-menu-id/index.md) |
| `DELETE` | `/api/public/nutrition-menus/{menuId}` | [Delete a nutrition menu](https://www.coach-platform.com/docs/api/reference/delete-nutrition-menus-menu-id/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/active-nutrition-menu` | [Get a trainee's active nutrition menu](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-active-nutrition-menu/index.md) |
| `POST` | `/api/public/nutrition-menus/{menuId}/meals/{mealId}/alternatives` | [Add an alternative meal](https://www.coach-platform.com/docs/api/reference/post-nutrition-menus-menu-id-meals-meal-id-alternatives/index.md) |
| `DELETE` | `/api/public/nutrition-menus/{menuId}/meals/{mealId}/alternatives/{alternativeId}` | [Remove an alternative meal](https://www.coach-platform.com/docs/api/reference/delete-nutrition-menus-menu-id-meals-meal-id-alternatives-alternative-id/index.md) |
| `GET` | `/api/public/food-items` | [Search the food database](https://www.coach-platform.com/docs/api/reference/get-food-items/index.md) |

## Meetings

Scheduled meetings.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/meetings` | [List meetings](https://www.coach-platform.com/docs/api/reference/get-meetings/index.md) |
| `POST` | `/api/public/meetings` | [Schedule a meeting](https://www.coach-platform.com/docs/api/reference/post-meetings/index.md) |
| `GET` | `/api/public/meetings/{meetingId}` | [Get a meeting](https://www.coach-platform.com/docs/api/reference/get-meetings-meeting-id/index.md) |
| `PATCH` | `/api/public/meetings/{meetingId}` | [Update a meeting](https://www.coach-platform.com/docs/api/reference/patch-meetings-meeting-id/index.md) |
| `DELETE` | `/api/public/meetings/{meetingId}` | [Delete a meeting](https://www.coach-platform.com/docs/api/reference/delete-meetings-meeting-id/index.md) |

## Forms

Coach forms.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/forms` | [List forms](https://www.coach-platform.com/docs/api/reference/get-forms/index.md) |
| `GET` | `/api/public/forms/registration` | [List registration form responses](https://www.coach-platform.com/docs/api/reference/get-forms-registration/index.md) |
| `GET` | `/api/public/updates` | [List check-in responses](https://www.coach-platform.com/docs/api/reference/get-updates/index.md) |
| `POST` | `/api/public/updates/{updateId}/respond` | [Respond to a check-in](https://www.coach-platform.com/docs/api/reference/post-updates-update-id-respond/index.md) |
| `GET` | `/api/public/forms/{formId}` | [Get a form with its questions](https://www.coach-platform.com/docs/api/reference/get-forms-form-id/index.md) |
| `GET` | `/api/public/forms/{formId}/response/{responseId}` | [Get a form response](https://www.coach-platform.com/docs/api/reference/get-forms-form-id-response-response-id/index.md) |
| `GET` | `/api/public/forms/{formId}/responses` | [List responses to a form](https://www.coach-platform.com/docs/api/reference/get-forms-form-id-responses/index.md) |

## Notifications

Send notifications to trainees.

| Method | Path | Endpoint |
|---|---|---|
| `POST` | `/api/public/notifications` | [Send a notification](https://www.coach-platform.com/docs/api/reference/post-notifications/index.md) |
| `POST` | `/api/public/notifications/bulk` | [Send a bulk notification](https://www.coach-platform.com/docs/api/reference/post-notifications-bulk/index.md) |

## Monitoring

Trainee adherence monitoring and stalled-exercise tracking.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/monitoring/overview` | [Get the monitoring overview](https://www.coach-platform.com/docs/api/reference/get-monitoring-overview/index.md) |
| `GET` | `/api/public/monitoring/training` | [List trainees with no recent training](https://www.coach-platform.com/docs/api/reference/get-monitoring-training/index.md) |
| `GET` | `/api/public/monitoring/steps` | [List trainees below their step target](https://www.coach-platform.com/docs/api/reference/get-monitoring-steps/index.md) |
| `GET` | `/api/public/monitoring/nutrition` | [List trainees with no recent nutrition logging](https://www.coach-platform.com/docs/api/reference/get-monitoring-nutrition/index.md) |
| `GET` | `/api/public/monitoring/nutrition/logged-today` | [List trainees who logged nutrition](https://www.coach-platform.com/docs/api/reference/get-monitoring-nutrition-logged-today/index.md) |
| `GET` | `/api/public/monitoring/nutrition/not-logged` | [List trainees who did not log nutrition](https://www.coach-platform.com/docs/api/reference/get-monitoring-nutrition-not-logged/index.md) |
| `GET` | `/api/public/monitoring/weight` | [Get weight monitoring](https://www.coach-platform.com/docs/api/reference/get-monitoring-weight/index.md) |
| `GET` | `/api/public/monitoring/water` | [List trainees with no recent water logging](https://www.coach-platform.com/docs/api/reference/get-monitoring-water/index.md) |
| `GET` | `/api/public/monitoring/updates` | [List weekly check-ins for monitoring](https://www.coach-platform.com/docs/api/reference/get-monitoring-updates/index.md) |
| `GET` | `/api/public/monitoring/incomplete-updates` | [List incomplete check-ins](https://www.coach-platform.com/docs/api/reference/get-monitoring-incomplete-updates/index.md) |
| `GET` | `/api/public/monitoring/stalled-exercises` | [List stalled exercises](https://www.coach-platform.com/docs/api/reference/get-monitoring-stalled-exercises/index.md) |
| `PATCH` | `/api/public/monitoring/incomplete-updates/read` | [Mark incomplete check-ins as read](https://www.coach-platform.com/docs/api/reference/patch-monitoring-incomplete-updates-read/index.md) |
| `POST` | `/api/public/monitoring/stalled-exercises/dismiss` | [Dismiss a stalled exercise](https://www.coach-platform.com/docs/api/reference/post-monitoring-stalled-exercises-dismiss/index.md) |
| `POST` | `/api/public/monitoring/stalled-exercises/dismiss-all` | [Dismiss stalled exercises in bulk](https://www.coach-platform.com/docs/api/reference/post-monitoring-stalled-exercises-dismiss-all/index.md) |
| `POST` | `/api/public/monitoring/stalled-exercises/undismiss` | [Undismiss a stalled exercise](https://www.coach-platform.com/docs/api/reference/post-monitoring-stalled-exercises-undismiss/index.md) |
| `POST` | `/api/public/monitoring/stalled-exercises/undismiss-all` | [Undismiss stalled exercises in bulk](https://www.coach-platform.com/docs/api/reference/post-monitoring-stalled-exercises-undismiss-all/index.md) |
| `POST` | `/api/public/monitoring/stalled-exercises/handle` | [Mark a stalled exercise as handled](https://www.coach-platform.com/docs/api/reference/post-monitoring-stalled-exercises-handle/index.md) |
| `POST` | `/api/public/monitoring/stalled-exercises/handle-all` | [Mark stalled exercises as handled in bulk](https://www.coach-platform.com/docs/api/reference/post-monitoring-stalled-exercises-handle-all/index.md) |
| `GET` | `/api/public/quick-wins` | [List quick wins](https://www.coach-platform.com/docs/api/reference/get-quick-wins/index.md) |

## Journeys

Customer journeys and trainee enrollment progress.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/journeys` | [List journeys](https://www.coach-platform.com/docs/api/reference/get-journeys/index.md) |
| `POST` | `/api/public/journeys` | [Create a journey](https://www.coach-platform.com/docs/api/reference/post-journeys/index.md) |
| `GET` | `/api/public/journeys/enrollments` | [List journey enrollments](https://www.coach-platform.com/docs/api/reference/get-journeys-enrollments/index.md) |
| `GET` | `/api/public/journeys/{journeyId}` | [Get a journey](https://www.coach-platform.com/docs/api/reference/get-journeys-journey-id/index.md) |
| `PATCH` | `/api/public/journeys/{journeyId}` | [Update a journey](https://www.coach-platform.com/docs/api/reference/patch-journeys-journey-id/index.md) |
| `GET` | `/api/public/journeys/{journeyId}/analytics` | [Get journey analytics](https://www.coach-platform.com/docs/api/reference/get-journeys-journey-id-analytics/index.md) |
| `POST` | `/api/public/journeys/{journeyId}/enroll` | [Enroll a trainee in a journey](https://www.coach-platform.com/docs/api/reference/post-journeys-journey-id-enroll/index.md) |
| `GET` | `/api/public/trainees/{traineeId}/journey-progress` | [Get a trainee's journey progress](https://www.coach-platform.com/docs/api/reference/get-trainees-trainee-id-journey-progress/index.md) |

## Employees

Team members.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/employees` | [List employees](https://www.coach-platform.com/docs/api/reference/get-employees/index.md) |

## Products

The coach product catalog and pricing.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/products` | [List products](https://www.coach-platform.com/docs/api/reference/get-products/index.md) |
| `GET` | `/api/public/products/{productId}` | [Get a product](https://www.coach-platform.com/docs/api/reference/get-products-product-id/index.md) |

## Purchases

Customer purchase records and membership status.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/purchases` | [List purchases](https://www.coach-platform.com/docs/api/reference/get-purchases/index.md) |
| `POST` | `/api/public/purchases` | [Record a purchase](https://www.coach-platform.com/docs/api/reference/post-purchases/index.md) |
| `GET` | `/api/public/purchases/{purchaseId}` | [Get a purchase](https://www.coach-platform.com/docs/api/reference/get-purchases-purchase-id/index.md) |

## Webhooks

Read configured webhooks.

| Method | Path | Endpoint |
|---|---|---|
| `GET` | `/api/public/webhooks` | [List webhook subscriptions](https://www.coach-platform.com/docs/api/reference/get-webhooks/index.md) |