Skip to main content

updateSessions

Update many sessions of one event as a single change. Every session is updated, or none is. Changes already sent to streaming platforms such as Zoom are not rolled back.

Each item takes the same fields as updateSession, and an omitted field is left unchanged. Different items may change different fields.

Each item's survey alias and uniqueCode must be free before the change, so swapping them between two sessions in one call is refused.

Throws an error with code:

  • BAD_USER_INPUT if sessions is empty, has more than 100 items, or names the same sessionId or survey alias more than once.
  • BAD_USER_INPUT if an item fails any of the checks updateSession makes on its input, for example duplicate trackNumbers, or a start or end outside the session block.
  • NOT_FOUND if an item's sessionId, locationId, sessionBlockId, or a contactId or sessionRoleId in its roleAssignments, is not associated with the event specified by the input's eventId field.
  • BAD_REQUEST if an item's survey alias is already in use, or if the change is refused, for example when a uniqueCode is already in use. No session is updated.

An error from the checks made on an item before the change is applied carries that item's position in sessions and its sessionId in the error's extensions, as index and sessionId. A BAD_REQUEST raised when the change is refused, for example for a uniqueCode already in use, does not carry them, and its message names the session instead.

updateSessions(
input: UpdateSessionsInput!
): UpdateSessionsPayload!

Arguments​

updateSessions.input ● UpdateSessionsInput! non-null input​

Type​

UpdateSessionsPayload object​

Payload when updating many sessions.