---
title: "Reschedule a scheduled Calendly session"
method: POST
path: "/api/participant/sessions/{sessionId}/reschedule"
tags: ["Participant Portal"]
---

# Reschedule a scheduled Calendly session

`POST /api/participant/sessions/{sessionId}/reschedule`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/api/participant/sessions/{sessionId}/reschedule`
- Auth: HTTP bearer

Reschedules a Calendly booking by canceling the existing booking and creating a new one at the selected time. The session status remains "scheduled" (AC7). If the new booking fails after cancel, the session reverts to "unscheduled" (1:1) or "cancelled" (check-in). Only works for sessions with scheduling_method = 'calendly' and status = 'scheduled'.

## Path parameters

- `sessionId` string, uuid, required

## Request body

- object
  - `scheduled_start` string, date-time, required: ISO 8601 UTC datetime for the new session start
  - `timezone` string, required: IANA timezone identifier (e.g., America/Denver)
  - `notes` string: Optional notes for the coach

## Response `200`

Session rescheduled successfully

- object
  - `success` boolean
  - `data` object
    - `rescheduled` boolean
    - `session_id` string
    - `scheduling_method` string

## Other responses

- `400`: Bad request — session not reschedulable or new time unavailable
- `401`: Unauthorized — authentication required
- `403`: Forbidden — session does not belong to this participant
- `404`: Session not found
- `500`: Internal server error

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)
