Skip to navigation

Update ticket notification settings

View as Markdown

Changes the fields you send and returns the full updated document.

Send only the fields you want to change, plus version with the num from your last read and a change_description. This is a JSON merge-patch: a field you leave out keeps its stored value, and every list or map you send replaces the stored one whole.

Authentication

AuthorizationBearer

JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.

Request

This endpoint expects an object.
versionobjectRequired
Document version. On update, send back the num from your last read.
watcher_ticket_filter_dslstringOptional
Moveworks DSL rule defining which tickets are eligible for notifications to ticket watchers. Must be a valid MWDSL expression.
ticket_update_notification_work_notes_enabledbooleanOptional
If true, a work note is added to the ticket for each ticket update notification sent to a user.
ticket_close_notificationobjectOptional

Which ticket state triggers closed-ticket notifications, with optional overrides per ticket type.

watcher_notifications_disabled_dslstringOptional
Moveworks DSL rule that, when it matches, stops ticket notifications from being sent to watchers. Must be a valid MWDSL expression.
user_notifiable_dslstringOptional
Moveworks DSL rule defining which users the assistant may send ticket notifications to for state changes and comments. Must be a valid MWDSL expression.
watcher_close_disabled_dslstringOptional
Moveworks DSL rule that, when it matches, prevents ticket watchers from resolving tickets. Must be a valid MWDSL expression.
business_hours_start_dslstringOptional

Moveworks DSL rule giving the start of business hours, local to the user, in HH:MM 24-hour time. Must be a valid MWDSL expression.

business_hours_end_dslstringOptional

Moveworks DSL rule giving the end of business hours, local to the user, in HH:MM 24-hour time. Must be a valid MWDSL expression.

geocode_business_hours_enabled_dslstringOptional
Moveworks DSL rule that, when it matches, determines the user's weekend days from their location instead of assuming a Monday to Friday week. Must be a valid MWDSL expression.
ticket_filters_in_bot_route_enabled_dslstringOptional
Moveworks DSL rule that, when it matches, also applies ticket filters when users query tickets. Must be a valid MWDSL expression.
tickets_visibility_restricted_dslstringOptional
Moveworks DSL rule that, when it matches, lets only a ticket's requestor look up that ticket. Must be a valid MWDSL expression.

Response

The updated ticket notification settings, at its new version
watcher_ticket_filter_dslstringOptional
Moveworks DSL rule defining which tickets are eligible for notifications to ticket watchers.
ticket_update_notification_work_notes_enabledbooleanOptional
If true, a work note is added to the ticket for each ticket update notification sent to a user.
ticket_close_notificationobjectOptional

Which ticket state triggers closed-ticket notifications, with optional overrides per ticket type.

watcher_notifications_disabled_dslstringOptional
Moveworks DSL rule that, when it matches, stops ticket notifications from being sent to watchers.
user_notifiable_dslstringOptional
Moveworks DSL rule defining which users the assistant may send ticket notifications to for state changes and comments.
watcher_close_disabled_dslstringOptional
Moveworks DSL rule that, when it matches, prevents ticket watchers from resolving tickets.
business_hours_start_dslstringOptional

Moveworks DSL rule giving the start of business hours, local to the user, in HH:MM 24-hour time.

business_hours_end_dslstringOptional

Moveworks DSL rule giving the end of business hours, local to the user, in HH:MM 24-hour time.

geocode_business_hours_enabled_dslstringOptional
Moveworks DSL rule that, when it matches, determines the user's weekend days from their location instead of assuming a Monday to Friday week.
ticket_filters_in_bot_route_enabled_dslstringOptional
Moveworks DSL rule that, when it matches, also applies ticket filters when users query tickets.
tickets_visibility_restricted_dslstringOptional
Moveworks DSL rule that, when it matches, lets only a ticket's requestor look up that ticket.
updated_timedatetimeOptionalRead-only
When the configuration was last updated.
updated_bystringOptionalRead-only
Who last updated the configuration.
versionobjectOptional
Document version. On update, send back the num from your last read.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error