> This page is for API Reference & Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Ticket Routing

> Read and update Ticket Routing through the Moveworks Configuration API: endpoints, fields and examples.

`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.

| Method  | Path                   | Endpoint reference                                                                                       |
| ------- | ---------------------- | -------------------------------------------------------------------------------------------------------- |
| `GET`   | `/tool/ticket/routing` | [Get ticket routing](/api-reference/configuration-api/ticketing/ticket-routing/get-ticket-routing)       |
| `PATCH` | `/tool/ticket/routing` | [Update ticket routing](/api-reference/configuration-api/ticketing/ticket-routing/update-ticket-routing) |

### Fields

| Field                                                       | Type                | Required  | Notes                                                                                                                   |
| ----------------------------------------------------------- | ------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
| `create_ticket_conditions`                                  | TicketRouteSettings |           | Routes that pick the workflow used when creating tickets. Defaults apply when unset.                                    |
| `query_ticket_conditions`                                   | TicketRouteSettings |           | Routes that pick the workflow used when looking up tickets. Defaults apply when unset.                                  |
| `update_ticket_conditions`                                  | TicketRouteSettings |           | Routes that pick the workflow used when updating tickets. Defaults apply when unset.                                    |
| `resolve_ticket_conditions`                                 | TicketRouteSettings |           | Routes that pick the workflow used when resolving tickets. Defaults apply when unset.                                   |
| `reopen_ticket_conditions`                                  | TicketRouteSettings |           | Routes that pick the workflow used when reopening tickets. Defaults apply when unset.                                   |
| `assign_ticket_to_bot_upon_resolution_reachout_enabled_dsl` | string              |           | Moveworks DSL rule. When it evaluates to true, tickets are assigned to the Moveworks agent when Moveworks acts on them. |
| `updated_time`                                              | string              | read-only | When the configuration was last updated.                                                                                |
| `updated_by`                                                | string              | read-only | Who last updated the configuration.                                                                                     |
| `version`                                                   | Version             |           | Document 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.

```json
{
  "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"
}
```