> 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 Filter Rules

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

`tool.ticket.filter-rule`

DSL filters scoping which tickets Moveworks processes.

* **Endpoint:** `/tool/ticket/filter-rule`  |  **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/filter-rule` | [Get ticket filter rules](/api-reference/configuration-api/ticketing/ticket-filter-rules/get-ticket-filter-rules)       |
| `PATCH` | `/tool/ticket/filter-rule` | [Update ticket filter rules](/api-reference/configuration-api/ticketing/ticket-filter-rules/update-ticket-filter-rules) |

### Fields

| Field                                 | Type    | Required  | Notes                                                                                                      |
| ------------------------------------- | ------- | --------- | ---------------------------------------------------------------------------------------------------------- |
| `universal_ticket_polling_filter_dsl` | string  |           | Moveworks DSL rule for the top-level ticket filter. Tickets that do not match are not processed at all.    |
| `resolution_ticket_filter_dsl`        | string  |           | Moveworks DSL rule defining the minimum criteria for a ticket to count toward resolution metrics.          |
| `ticket_interception_filter_dsl`      | string  |           | Moveworks DSL rule defining which tickets are eligible for resolution actions such as ticket interception. |
| `concierge_ticket_filter_dsl`         | string  |           | Moveworks DSL rule defining which tickets are eligible for ticket activity updates.                        |
| `nudge_ticket_filter_dsl`             | string  |           | Moveworks DSL rule defining which tickets qualify for nudges (follow-ups from the assistant).              |
| `triage_ticket_route_filter_dsl`      | string  |           | Moveworks DSL rule defining which tickets the triage model or triage rules may update.                     |
| `knowledge_studio_ticket_filter_dsl`  | string  |           | Moveworks DSL rule defining which tickets Knowledge Studio processes to generate knowledge articles.       |
| `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
{
  "universal_ticket_polling_filter_dsl": "true",
  "resolution_ticket_filter_dsl": "true",
  "ticket_interception_filter_dsl": "true",
  "concierge_ticket_filter_dsl": "true",
  "nudge_ticket_filter_dsl": "true",
  "triage_ticket_route_filter_dsl": "true",
  "knowledge_studio_ticket_filter_dsl": "true"
}
```