VEvetcove
Scheduler

Update an appointment

Updates an existing appointment by its ID. Supports status changes, cancellation with reason, rescheduling to new times/resources, and optional client notifications.

put/ext/v2/appointments/{appointment_id}/

Request

  • Base URL
    https://connect.vetcove.com
  • URL
    https://connect.vetcove.com/ext/v2/appointments/{appointment_id}/
  • Auth
    HTTP bearer

Path parameters

appointment_idinteger required

The ID of the appointment to update

Request body

cancelation_reason'PATIENT_SEEN_ELSEWHERE' | 'CONCERN_RESOLVED' | 'PENDING_RESCHEDULE' | 'NO_LONGER_NEEDED' | 'WILL_RESCHEDULE' | 'DOCTOR_UNAVAILABLE' | 'CLINIC_SCHEDULE_CHANGE' | 'CREATED_IN_ERROR' | 'DUPLICATE' | 'WRONG_PATIENT' | 'WRONG_DATE_OR_TIME' | 'UNKNOWN' | 'OTHER' | 'NO_SHOW'
cancelation_reason_otherstring nullable

Optional explanation when cancelation_reason is OTHER. Not required. Rejected when sent with any other reason.

custom_messagestring

Custom message to include in the client notification. Only used if should_notify_client is true.

end_datetimestring date-time nullable

ISO 8601 formatted datetime for when the appointment ends. Must be provided together with start_datetime.

resource_idinteger nullable

The ID of the calendar resource (provider/room) to assign to this appointment.

should_notify_clientboolean

Whether to send a notification to the client about this update.

start_datetimestring date-time nullable

ISO 8601 formatted datetime for when the appointment starts. Must be provided together with end_datetime.

status'CREATING' | 'CLIENT_CREATING' | 'UNSCHEDULED' | 'UNCONFIRMED' | 'CONFIRMED' | 'DROPPED_OFF' | 'CHECKED_IN' | 'IN_PROGRESS' | 'READY_TO_GO' | 'COMPLETED' | 'NO_SHOW' | 'CANCELED' | 'IMPORTED' | 'CLIENT_REQUESTED'

Response

OK

calendar_idinteger required

The ID of the calendar this appointment belongs to.

cancelation_reason_otherstring nullable required

Free-text explanation of the cancelation, if one was provided.

clinic_client_idinteger nullable required

The ID of the clinic client responsible for the appointment.

clinic_idinteger required

The ID of the clinic this appointment belongs to.

clinic_notesunknown required
clinic_patient_idinteger nullable required

The ID of the clinic patient this appointment is for.

createdstring date-time required

The datetime this object was created.

deletedstring date-time nullable required

The datetime this record was soft deleted.

dropoff_start_datetimestring date-time nullable required

ISO 8601 formatted datetime for when the patient should be dropped off.

end_datetimestring date-time nullable required

ISO 8601 formatted datetime for when the appointment ends.

followup_appointment_idsinteger[]

List of followup appointment IDs associated with this appointment.

idinteger required

The unique identifier for the appointment.

is_deletedboolean required

Whether this record is soft deleted or not.

kindstring nullable

The appointment kind (type of appointment).

kind_idinteger nullable

The ID of the appointment kind (type of appointment).

medical_record_idinteger nullable

The ID of the medical record associated with this appointment, if any.

modifiedstring date-time required

The datetime this object was last modified; changes to related entities will not update this field.

pickup_start_datetimestring date-time nullable required

ISO 8601 formatted datetime for when the patient should be picked up.

reasonstring nullable required

The reason for this appointment.

resource_idinteger nullable required

The ID of the calendar resource (provider/room) assigned to handle this appointment.

resource_namestring nullable

The name of the calendar resource (provider/room) assigned to handle this appointment.

room_idinteger nullable required

The ID of the room assigned to this appointment, if any.

room_namestring nullable

The name of the room assigned to this appointment, if any.

start_datetimestring date-time nullable required

ISO 8601 formatted datetime for when the appointment starts.

status'CREATING' | 'CLIENT_CREATING' | 'UNSCHEDULED' | 'UNCONFIRMED' | 'CONFIRMED' | 'DROPPED_OFF' | 'CHECKED_IN' | 'IN_PROGRESS' | 'READY_TO_GO' | 'COMPLETED' | 'NO_SHOW' | 'CANCELED' | 'IMPORTED' | 'CLIENT_REQUESTED' required

Changes

No recorded changes to this operation across all 1 revision of this API.