overrideBookingStatus

Mutation

Override the status on a booking.

An override can be used to move a booking from any status to any other status. To override a booking without a space to a booking with a space, both areaId and spaceId must be provided.

When overriding a status, all fields can be considered optional.

Permission Required

This operation requires the BookingStatusOverride permission.

Signature

mutation {
  overrideBookingStatus(
    organisationId: UUID!
    bookingId: ID!
    statusId: UUID
    fields: [FieldDataInput!]
    formSubmissions: [FormSubmissionInput!]
    areaId: UUID
    spaceId: UUID
    time: Timestamp
    duration: Int
    statusReference: BookingStatusEntityRefInput
  ): Void
}

Arguments

Argument	Type	Default	Description
organisationId*	UUID!	—	The ID of the organisation
bookingId*	ID!	—	The ID of the booking
statusId	UUID	—	The ID of the status to be updated to.
fields	[FieldDataInput!]	—	An array of inputs containing new or updated field data
formSubmissions	[FormSubmissionInput!]	—	An array of inputs containing new or updated form submissions
areaId	UUID	—	The ID of the area to be booked to
spaceId	UUID	—	The ID of the space to be booked to
time	Timestamp	—	The time to be assigned to the booking
duration	Int	—	The duration of the booking
statusReference	BookingStatusEntityRefInput	—	An status reference input containing new or updated field data

Return type

Void (Void)

Example

GraphQL

mutation OverrideBookingStatus($organisationId: UUID!, $bookingId: ID!, $statusId: UUID, $fields: [FieldDataInput!], $formSubmissions: [FormSubmissionInput!], $areaId: UUID, $spaceId: UUID, $time: Timestamp, $duration: Int, $statusReference: BookingStatusEntityRefInput) {
  overrideBookingStatus(organisationId: $organisationId, bookingId: $bookingId, statusId: $statusId, fields: $fields, formSubmissions: $formSubmissions, areaId: $areaId, spaceId: $spaceId, time: $time, duration: $duration, statusReference: $statusReference)
}

curl

curl -X POST https://my.mobiledock.com/api/v1/graphql \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation OverrideBookingStatus($organisationId: UUID!, $bookingId: ID!, $statusId: UUID, $fields: [FieldDataInput!], $formSubmissions: [FormSubmissionInput!], $areaId: UUID, $spaceId: UUID, $time: Timestamp, $duration: Int, $statusReference: BookingStatusEntityRefInput) { overrideBookingStatus(organisationId: $organisationId, bookingId: $bookingId, statusId: $statusId, fields: $fields, formSubmissions: $formSubmissions, areaId: $areaId, spaceId: $spaceId, time: $time, duration: $duration, statusReference: $statusReference) }",
    "variables": {
          "organisationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "bookingId": "MDB-26-XXXX-XXXX"
    }
  }'

JavaScript

const response = await fetch('https://my.mobiledock.com/api/v1/graphql', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    query: `
      mutation OverrideBookingStatus($organisationId: UUID!, $bookingId: ID!, $statusId: UUID, $fields: [FieldDataInput!], $formSubmissions: [FormSubmissionInput!], $areaId: UUID, $spaceId: UUID, $time: Timestamp, $duration: Int, $statusReference: BookingStatusEntityRefInput) {
        overrideBookingStatus(organisationId: $organisationId, bookingId: $bookingId, statusId: $statusId, fields: $fields, formSubmissions: $formSubmissions, areaId: $areaId, spaceId: $spaceId, time: $time, duration: $duration, statusReference: $statusReference)
      }
    `,
    variables: {
          "organisationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "bookingId": "MDB-26-XXXX-XXXX"
    },
  }),
});

const data = await response.json();