Create a path

POST /api/v1/programs/{programId}/paths

Creates version 1 of a new path family. Copying the primary path reuses milestone ids.

Authorization

Allowed for OWNER, ADMIN, or a MEMBER with an organization-scoped program_director assignment. Archived Programs refuse writes.

Request headers

x-api-key and Idempotency-Key are required.

Request body

Example

curl -X POST "$COHORTE_API_BASE_URL/api/v1/programs/$PROGRAM_ID/paths" -H "x-api-key: $COHORTE_API_KEY" -H "Idempotency-Key: path-accelerated" -H "Content-Type: application/json" -d '{"name":"Accelerated","duplicatePrimary":true}'

Response

201 when created, 200 on replay, 400, 401, 403, 404, or 500 otherwise.

Example response

{"success":true,"data":{"id":"…","version":1,"name":"Accelerated","isPrimary":false,"steps":[]}}

Notes

Creating a path does not make it primary and never changes an enrollment.

Related

• /en/docs/api/paths/list-program-paths
• /en/docs/api/paths/update-a-path