---
title: "POST /api/public/journeys/{journeyId}/enroll"
method: POST
path: "/api/public/journeys/{journeyId}/enroll"
tags: ["Journeys"]
---

# POST /api/public/journeys/{journeyId}/enroll

`POST /api/public/journeys/{journeyId}/enroll`

## Request

- Base URL: `https://api.coach-platform.com`
- URL: `https://api.coach-platform.com/api/public/journeys/{journeyId}/enroll`
- Auth: HTTP bearer

Enroll one trainee into an active journey. Identify them with traineeId (their active coaching period is used) or with escortId to pick a specific coaching period. A trainee already enrolled in another journey returns 409 unless replaceExisting is true. Enrollments are limited to one per second per coach, so space out loops that enroll many trainees.

## Path parameters

- `journeyId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `traineeId` string: The trainee to enroll, resolved to their active coaching period. Send this or escortId.
  - `escortId` string: The coaching period to enroll. Send this or traineeId when you need a specific one.
  - `startDateShiftDays` integer: Shift the journey start by this many days. Negative values start it in the past, so earlier steps fire immediately.
  - `startAtStepId` string: Begin at this step instead of the first one.
  - `replaceExisting` boolean: Cancel the trainee's current enrollment in another journey instead of returning 409.

## Response `201`

Created

- object: Created
  - `data` object
  - `warnings` object[]: Non-fatal problems with follow-up writes. The resource was created, but each listed field was not applied.
    - `field` string
    - `message` string

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `409`: Default Response
- `429`: Default Response
- `500`: Default Response

## Changes

- **2026-09-07** `3415f727fede`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coach-platform/apis/coach-platform-api/changes/api/public/journeys/:journeyId/enroll/post.md)

---

[API](https://skmtc.dev/coach-platform/apis/coach-platform-api.md) - [All operations](https://skmtc.dev/coach-platform/apis/coach-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coach-platform/apis/coach-platform-api/revisions/c75a8bd18dee?raw)
