# Reschedule appointment

This endpoint is used to only modify the appointment time and request the reschedule of an appointment in pending_booking, confirmed, pending_reschedule, or rescheduled status. Developers must send a valid  and a new start time as input in the request body.

If the appointment was booked with a Zocdoc user credential, only that user will have access to view or modify the appointment. If the appointment was booked with a machine-to-machine credential, the appointment can be viewed and modified by any of the developer's machine-to-machine credentials.


Endpoint: POST /v1/appointments/reschedule
Version: 1.22
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Request fields (application/json):

  - `appointment_id` (string, required)
    The Zocdoc id of the appointment
    Example: "63f995c2-49c4-40c8-a93a-140fb32e913b"

  - `start_time` (string, required)
    Date & time of the appointment in ISO-8601 format with a timezone offset
    Example: "2022-04-27T09:00:00-04:00"

## Response 200 fields (application/json):

  - `request_id` (string, required)

  - `data` (object, required)
    Data that will be returned upon a sucessful booking request

  - `data.appointment_id` (string, required)
    The Zocdoc ID of the appointment.

  - `data.appointment_status` (string, required)
    The status of the appointment. See [Appointment Status definitions](/guides/glossary).
    Enum: "pending_booking", "confirmed", "booking_failed", "cancelled", "no_show", "pending_reschedule", "rescheduled", "reschedule_failed"

  - `data.developer_patient_id` (string)

  - `data.is_provider_resource` (boolean, required)
    Whether the appointment will be performed by a professional under the supervision of the booked provider.

  - `data.location_phone_number` (string)
    The appointment location's unformatted 10 digit phone number
    Example: "9999999999"

  - `data.location_phone_extension` (string)
    The appointment location's unformatted extension number, as digits

  - `data.waiting_room_path` (string)
    Patient facing url that can be used to navigate to Zocdoc video service appointments

  - `data.confirmation_type` (string, required)
    Specifies how the appointment confirmation will be handled.
  * auto: means the system will automatically confirm.
  * manual: means confirmation requires user action.
  * pending_evaluation: indicates that the confirmation approach is pending evaluation.
    Enum: "auto", "manual", "pending_evaluation"

  - `data.visit_type` (string, required)
    The appointment's [visit type](/guides/glossary)
    Enum: "in_person", "zocdoc_video_service", "third_party_video_service"

  - `data.notes` (string)
    Patient notes

## Response 400 fields (application/json):

  - `request_id` (string, required)

  - `error_type` (string, required)
    Enum: "api_error", "invalid_request"

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)

## Response 404 fields (application/json):

  - `request_id` (string, required)

  - `error_type` (string, required)
    Enum: "api_error", "invalid_request"

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)

## Response 409 fields (application/json):

  - `request_id` (string, required)

  - `error_type` (string, required)
    Enum: "api_error", "invalid_request"

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)