Input fields

alignRequestStatusWithAppointment : Boolean default: True

When true, automatically updates the request status to match its appointments. Defaults to true.
appointmentStatus : OnSiteJobsAppointmentStatus! required

The current status of the appointment.
assets : [OnSiteJobsAssetInput!]

List of assets associated with the appointment.
cancellationCategory : OnSiteJobsAppointmentCancellationCategory

The cancellation reason for this appointment.
comments : String

Appointment related comments.
commsStrategy : OnSiteJobsCommsStrategy! required

The comms strategy.
endAt : DateTime

The end date/time of this appointment.
externalReference : String! required

The external reference provided by the vendor/contractor for the appointment.
jobDetails : OnSiteJobsAppointmentJobDetailsInput! required

Appointment job details.
jobNotes : JSONString

The job notes.
jobType : NonEmptyString! required

The type of job this appointment is for.
requestId : UUID! required

The UUID of the On-Site Jobs request appointment is for.
runActionsBasedOnStatus : Boolean default: True

Whether to run the side-effect action based on the new appointment status. Only applicable if a value was provided in the status field. Defaults to true.
startAt : DateTime! required

The start date/time of this appointment.
The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

Example

{ "alignRequestStatusWithAppointment": true, "appointmentStatus": "REQUIRES_TIMESLOT", "assets": OnSiteJobsAssetInput, "cancellationCategory": "CANCELLED_BY_CUSTOMER___COMPLAINT", "comments": "authority-subject-wish-imagine-across", "commsStrategy": "SEND_ALL", "endAt": "2000-02-07T08:35:01.596182+00:00", "externalReference": "herself-then-baby-past-member", "jobDetails": OnSiteJobsAppointmentJobDetailsInput, "jobNotes": {"key": "value"}, "jobType": "official-international-goal-write-according", "requestId": "b0fb4bc8-b22c-4347-8ca2-7b41f5e4c4bb", "runActionsBasedOnStatus": true, "startAt": "2006-05-01T12:58:16.273751+00:00" }