Update Appointment Resource - OnyeOne Documentation

A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s).

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

appointment_id

string

required

Body Params application/json

status

enum<string>

optional

Allowed values:

proposedpendingbookedarrivedfulfilledcancellednoshowentered-in-errorchecked-inwaitlist

participant

array [object {5}]

optional

type

enum<string>

required

Allowed values:

admitterattendercallback contactconsultantdischargerescortreferrersecondary performerprimary performerParticipationTranslatorEmergency

actor

object

required

boolean

required

Whether this participant is required to be present at the meeting.

status

enum<string>

optional

Participation status of the actor.

Allowed values:

accepteddeclinedtentativeneeds-action

period

object

optional

Participation period of the actor.

reason_reference

array [object {2}]

optional

Reason the appointment has been scheduled to take place, as specified using information from another resource.

type

enum<string>

required

See http://hl7.org/fhir/ValueSet/encounter-reason for codes and name.

Allowed values:

conditionprocedureobservationimmunization_recommendation

string

required

ID of type above

reason_code

array [object {2}]

optional

code

string

required

See http://hl7.org/fhir/ValueSet/encounter-reason for codes and name.

name

string

required

cancellation_reason

enum<string>

optional

The coded reason for the appointment being cancelled. This is often used in reporting/billing/futher processing to determine if further actions are required, or specific fees apply.

Allowed values:

patpat-crspat-decpat-ltpat-no-shwprovprov-persprov-techprov-zoomsysoth

description

string

optional

The brief description of the appointment as would be shown on a subject line in a meeting request, or appointment list. Detailed or expanded information should be put in the comment field.

start

string

optional

Date/Time that the appointment is to take place. An instant in time in the format YYYY-MM-DDThh:mm:ss.sss+zz:zz (e.g. 2015-02-07T13:28:17.239+02:00 or 2017-01-01T00:00:00Z).

end

string

optional

Date/Time that the appointment is to conclude. n instant in time in the format YYYY-MM-DDThh:mm:ss.sss+zz:zz (e.g. 2015-02-07T13:28:17.239+02:00 or 2017-01-01T00:00:00Z).

minutes_duration

number

optional

Number of minutes that the appointment is to take.

>= 0

slot

array[string]

optional

The slots from the participants' schedules that will be filled by the appointment.

comment

string

optional

Additional comments about the appointment.

patient_instruction

string

optional

While Appointment.comment contains information for internal use, Appointment.patientInstructions is used to capture patient facing information about the Appointment (e.g. please bring your referral or fast from 8pm night before).

based_on

array[string]

optional

The service request this appointment is allocated to assess (e.g. incoming referral or procedure request).

requested_period

array [object {2}]

optional

start

string

required

YYYY-MM-DD format

end

string

required

YYYY-MM-DD format

Example

{
  "status": "fulfilled",
  "description": "Examination",
  "start": "2025-02-07T13:28:17.239+02:00",
  "end": "2025-02-07T17:30:17.239+02:00",
  "minutes_duration": 62
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

message

string

required

resource_id

string

required

updated_fields

object

required

status

string

optional

description

string

optional

start

string

optional

end

string

optional

minutesDuration

integer

optional

Example

{
  "message": "Appointment resource updated successfully.",
  "resource_id": "339d4678-8482-5d81-b000-346edfd86484",
  "updated_fields": {
    "status": "fulfilled",
    "description": "Examination",
    "start": "2025-02-07T13:28:17.239+02:00",
    "end": "2025-02-07T17:30:17.239+02:00",
    "minutesDuration": 62
  }
}