Skip to navigation

Ticket Routing

View as Markdown

tool.ticket.routing

Which workflow each ticket action runs. Defaults load when unset; setting a *_ticket_conditions group REPLACES the shipped defaults for that action wholesale. A dangling workflow reference fails configuration publish.

  • Endpoint: /tool/ticket/routing | Methods: GET, PATCH
  • Request shape: one per organization, so there is no id. It already exists: read it with GET, then PATCH the fields you want to change. Fields go at the top level of the JSON body, with no resource wrapper.
  • Updates: a JSON merge-patch. Send only the fields you change, plus version: {num, change_description} with the num from your last read. Lists and maps you send replace the stored ones whole.

Endpoints

All paths are relative to https://api.moveworks.ai/configurations/v1alpha1. Each endpoint page lists the request and response schema, an example, and the errors it can return.

MethodPathEndpoint reference
GET/tool/ticket/routingGet ticket routing
PATCH/tool/ticket/routingUpdate ticket routing

Fields

FieldTypeRequiredNotes
create_ticket_conditionsTicketRouteSettingsRoutes that pick the workflow used when creating tickets. Defaults apply when unset.
query_ticket_conditionsTicketRouteSettingsRoutes that pick the workflow used when looking up tickets. Defaults apply when unset.
update_ticket_conditionsTicketRouteSettingsRoutes that pick the workflow used when updating tickets. Defaults apply when unset.
resolve_ticket_conditionsTicketRouteSettingsRoutes that pick the workflow used when resolving tickets. Defaults apply when unset.
reopen_ticket_conditionsTicketRouteSettingsRoutes that pick the workflow used when reopening tickets. Defaults apply when unset.
assign_ticket_to_bot_upon_resolution_reachout_enabled_dslstringMoveworks DSL rule. When it evaluates to true, tickets are assigned to the Moveworks agent when Moveworks acts on them.
updated_timestringread-onlyWhen the configuration was last updated.
updated_bystringread-onlyWho last updated the configuration.
versionVersionDocument version. On update, send back the num from your last read.

Document fields (example)

The document as GET returns it. To change any of these, send only the fields you want to change in the PATCH body.

{
"create_ticket_conditions": {
"default_workflow_id": "<workflow-display-name-or-id>",
"conditional_routes": [
{
"condition_dsl": "true",
"workflow_id": "<workflow-display-name-or-id>",
"item_ref": "<string>"
}
]
},
"query_ticket_conditions": {
"default_workflow_id": "<workflow-display-name-or-id>",
"conditional_routes": [
{
"condition_dsl": "true",
"workflow_id": "<workflow-display-name-or-id>",
"item_ref": "<string>"
}
]
},
"update_ticket_conditions": {
"default_workflow_id": "<workflow-display-name-or-id>",
"conditional_routes": [
{
"condition_dsl": "true",
"workflow_id": "<workflow-display-name-or-id>",
"item_ref": "<string>"
}
]
},
"resolve_ticket_conditions": {
"default_workflow_id": "<workflow-display-name-or-id>",
"conditional_routes": [
{
"condition_dsl": "true",
"workflow_id": "<workflow-display-name-or-id>",
"item_ref": "<string>"
}
]
},
"reopen_ticket_conditions": {
"default_workflow_id": "<workflow-display-name-or-id>",
"conditional_routes": [
{
"condition_dsl": "true",
"workflow_id": "<workflow-display-name-or-id>",
"item_ref": "<string>"
}
]
},
"assign_ticket_to_bot_upon_resolution_reachout_enabled_dsl": "true"
}