Skip to main content
POST
Reschedule a booked call
Move a booked call to a new time. Runs the same lifecycle pipeline as a reschedule performed in the Aura dashboard:
  • The calendar event is moved to the new time and guests are notified
  • Reschedule emails are dispatched and guest reminders are rescheduled
  • The meeting recording is re-pointed at the new time
  • The call.rescheduled webhook fires to all subscribers (single emitter — do not expect a second event from this endpoint)
Constraints: scheduled_at must be a future instant within 60 days; a time further ahead fails with 400 VALIDATION_ERROR. The host’s working hours apply. A genuine calendar conflict surfaces as a 422 from the upstream provider. Use GET /v1/booking-links/{id}/availability first to offer only bookable slots. Cancelled calls: a cancelled call is refused. Its calendar event is gone, so the request fails with 409 CALL_CANCELLED and nothing changes. Book a new call for the new time instead. A call already moved to a new call, or a call with no host, fails with 409 CONFLICT. A declined call can still be rescheduled; the new time asks the guest again. Upstream failures: provider-rejected reschedules (including no-longer-available slots) fail with 422 EXTERNAL_API_ERROR; a degraded provider fails with 502 EXTERNAL_API_ERROR.

Path Parameters

id
string
required

Call ID (UUID)

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json
scheduled_at
string<date-time>
required

New start time as an ISO-8601 datetime (UTC or with offset). Must be in the future.

Example:

"2026-08-01T15:00:00Z"

timezone
string

Optional IANA timezone for display context (e.g. Europe/Berlin). Does not change the instant — scheduled_at is authoritative.

Example:

"Europe/Berlin"

Response

Call rescheduled. Returns the updated call.

data
object
required
success
enum<boolean>
required
Available options:
true