Skip to navigation

Update ticket poller

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.
ticket_poller_enabled_dslstringOptional
Moveworks DSL rule that turns on polling of your ticketing systems for new tickets and updates. Must be a valid MWDSL expression.
itsm_webhook_processing_enabled_dslstringOptional
Moveworks DSL rule that turns on processing of webhook events from your ITSM system. Enable only if ticket syncing with channel resolver is configured. Must be a valid MWDSL expression.
poll_interval_secondsintegerOptional
How often, in seconds, the ticketing system is polled for tickets.
maximum_look_back_secondsintegerOptional
Maximum age, in seconds, of tickets polled, which limits how far behind the current time polling can fall. Between 30 and 600.
grace_period_secondsintegerOptional
How far, in seconds, polling stays behind the current time to allow for delays in the ticketing system's data. Between 10 and 600.

Response

The updated ticket poller, at its new version
ticket_poller_enabled_dslstringOptional
Moveworks DSL rule that turns on polling of your ticketing systems for new tickets and updates.
itsm_webhook_processing_enabled_dslstringOptional
Moveworks DSL rule that turns on processing of webhook events from your ITSM system. Enable only if ticket syncing with channel resolver is configured.
poll_interval_secondsintegerOptional
How often, in seconds, the ticketing system is polled for tickets.
maximum_look_back_secondsintegerOptional
Maximum age, in seconds, of tickets polled, which limits how far behind the current time polling can fall. Between 30 and 600.
grace_period_secondsintegerOptional
How far, in seconds, polling stays behind the current time to allow for delays in the ticketing system's data. Between 10 and 600.
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