setBookingFields

Mutation

Update a booking with field overrides. Does not respect required/not required fields, and can only be done by the location.

If the organisation specified is the carrier, you need the ParticipateCarrierBookings permission. If the organisation specified is the location, you need the ParticipateLocationBookings permission. The specified location must also be the carrier.

Permission Required

This operation requires the BookingFieldsOverride permission.

Signature

mutation {
  setBookingFields(
    organisationId: UUID!
    bookingId: ID!
    fields: [FieldDataInput!]
    fieldReferences: [FieldDataEntityRefInput!]
  ): Void
}

Arguments

Argument	Type	Default	Description
organisationId*	UUID!	—	The ID of the organisation
bookingId*	ID!	—	The ID of the booking
fields	[FieldDataInput!]	—	An array of inputs containing field data details for the given booking
fieldReferences	[FieldDataEntityRefInput!]	—	An array of inputs containing field data reference details for the given booking

Return type

Void (Void)

Example

GraphQL

mutation SetBookingFields($organisationId: UUID!, $bookingId: ID!, $fields: [FieldDataInput!], $fieldReferences: [FieldDataEntityRefInput!]) {
  setBookingFields(organisationId: $organisationId, bookingId: $bookingId, fields: $fields, fieldReferences: $fieldReferences)
}

curl

curl -X POST https://my.mobiledock.com/api/v1/graphql \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation SetBookingFields($organisationId: UUID!, $bookingId: ID!, $fields: [FieldDataInput!], $fieldReferences: [FieldDataEntityRefInput!]) { setBookingFields(organisationId: $organisationId, bookingId: $bookingId, fields: $fields, fieldReferences: $fieldReferences) }",
    "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 SetBookingFields($organisationId: UUID!, $bookingId: ID!, $fields: [FieldDataInput!], $fieldReferences: [FieldDataEntityRefInput!]) {
        setBookingFields(organisationId: $organisationId, bookingId: $bookingId, fields: $fields, fieldReferences: $fieldReferences)
      }
    `,
    variables: {
          "organisationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "bookingId": "MDB-26-XXXX-XXXX"
    },
  }),
});

const data = await response.json();