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

# Channel Resolvers

> Create, read and update Channel Resolvers through the Moveworks Configuration API: endpoints, fields and examples.

`assistant.channel-resolver`

Assistant on a Slack channel.

* **Endpoint:** `/assistant/channel-resolver`  |  **Methods:** GET, PATCH, POST
* **Request shape:** fields go at the top level of the JSON body, with no `resource` wrapper. The item's `id` goes in the URL for reads and updates, not in the body.
* **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`   | `/assistant/channel-resolver`      | [List channel resolvers](/api-reference/configuration-api/platform-org/channel-resolvers/list-channel-resolvers)   |
| `POST`  | `/assistant/channel-resolver`      | [Create channel resolver](/api-reference/configuration-api/platform-org/channel-resolvers/create-channel-resolver) |
| `GET`   | `/assistant/channel-resolver/{id}` | [Get channel resolver](/api-reference/configuration-api/platform-org/channel-resolvers/get-channel-resolver)       |
| `PATCH` | `/assistant/channel-resolver/{id}` | [Update channel resolver](/api-reference/configuration-api/platform-org/channel-resolvers/update-channel-resolver) |

### Fields

| Field                                | Type                    | Required  | Notes                                                                                                                                                                                                                                                                                                         |
| ------------------------------------ | ----------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                 | string                  | read-only | Unique identifier of this configuration, assigned by the server.                                                                                                                                                                                                                                              |
| `slack_channel_name`                 | string                  | ✅         | Display name of the Slack channel, without the leading #.                                                                                                                                                                                                                                                     |
| `slack_channel_id`                   | string                  |           | ID of the Slack channel this configuration applies to. Cannot be changed after creation.                                                                                                                                                                                                                      |
| `domains_enabled`                    | array\<enum>            |           | Domains the assistant responds to in this channel. If empty, it responds to all posts; otherwise only to posts classified into these domains. One of: `UNKNOWN_DOMAIN`, `IT_DOMAIN`, `HR_DOMAIN`, `FACILITY_DOMAIN`, `FINANCE_DOMAIN`, `LEGAL_DOMAIN`, `PAYROLL_DOMAIN`, `PROCUREMENT_DOMAIN`, … (14 values). |
| `skills_disabled`                    | array\<enum>            |           | Skills disabled in this channel. Any of ACCESS_SW, ACCESS_DL, ACCESS_ACCOUNT, ENTERPRISE_SEARCH, or FORM. One of: `ACCESS_SW`, `ACCESS_DL`, `ACCESS_ACCOUNT`, `ENTERPRISE_SEARCH`, `FORM`.                                                                                                                    |
| `subskills_disabled`                 | array\<enum>            |           | Account Access sub-skills disabled in this channel. Any of ACCOUNT_UNLOCK, MFA_RESET, or FORGOT_PASSWORD. Disabling ACCESS_ACCOUNT already disables all of them. One of: `ACCOUNT_UNLOCK`, `MFA_RESET`, `FORGOT_PASSWORD`.                                                                                    |
| `feedback_enabled_skills`            | array\<enum>            |           | Skills that show feedback (post-back) buttons in the channel. Any of ACCESS_SW, ACCESS_DL, ACCESS_ACCOUNT, or FORM. One of: `ACCESS_SW`, `ACCESS_DL`, `ACCESS_ACCOUNT`, `FORM`.                                                                                                                               |
| `ticket_filing_disabled`             | boolean                 |           | If true, no ticket is filed when a user does not get a correct response in the channel. Useful when channel questions do not belong in your ticketing system.                                                                                                                                                 |
| `responding_to_agents_enabled`       | boolean                 |           | If true, the assistant also responds to IT agents in the channel. By default, agents are ignored.                                                                                                                                                                                                             |
| `handoff_when_no_response_enabled`   | boolean                 |           | If true, when the assistant has no answer it offers the user handoff options in a DM, such as filing a ticket or talking to an agent. The issue is not marked resolved if handoff is used.                                                                                                                    |
| `emoji_for_no_resolution`            | string                  |           | Emoji the assistant reacts with when it cannot resolve a post. Defaults to exclamation. Must differ from emoji_for_resolution and emoji_for_ticket_filed.                                                                                                                                                     |
| `emoji_for_resolution`               | string                  |           | Emoji the assistant reacts with when it provides a resolution. Defaults to white_check_mark. Must differ from emoji_for_no_resolution and emoji_for_ticket_filed.                                                                                                                                             |
| `emoji_for_ticket_filed`             | string                  |           | Emoji the assistant reacts with when a ticket is filed. Defaults to ticket. Must differ from emoji_for_no_resolution and emoji_for_resolution.                                                                                                                                                                |
| `emoji_when_no_response_enabled`     | boolean                 |           | If true, the assistant reacts with emoji_for_no_response when it has no response to a post.                                                                                                                                                                                                                   |
| `emoji_for_no_response`              | string                  |           | Emoji the assistant reacts with when it has no response to a post. Defaults to exclamation.                                                                                                                                                                                                                   |
| `emoji_for_manual_creation`          | string                  |           | Emoji that, when applied to a user's post, creates a synced ticket in your ticketing system.                                                                                                                                                                                                                  |
| `emoji_for_automatic_ticket`         | string                  |           | Emoji the assistant applies to non-agent posts when it automatically creates a ticket. Defaults to ticket.                                                                                                                                                                                                    |
| `emoji_for_assign_ticket`            | string                  |           | Emoji an IT agent applies to a post to assign its ticket to themselves.                                                                                                                                                                                                                                       |
| `ticket_syncing_enabled`             | boolean                 |           | If true, Slack thread messages and user-facing ticket comments are synced in both directions. Requires webhooks to be configured in your ticketing system.                                                                                                                                                    |
| `ticket_creation_criteria`           | enum                    |           | When synced tickets are created: MANUAL_ONLY when an agent applies the manual creation emoji, or FULLY_SYNCED for every non-agent post. One of: `TICKET_CREATION_CRITERIA_MANUAL_ONLY`, `TICKET_CREATION_CRITERIA_FULLY_SYNCED`.                                                                              |
| `assign_ticket_to_bot_upon_reachout` | boolean                 |           | If true, tickets created from a channel reachout are assigned to the assistant's service account, and unassigned if the user says the reachout was not helpful.                                                                                                                                               |
| `workflows`                          | array\<ChannelWorkflow> |           | Slack workflows that post in this channel, so the assistant can extract the requester and issue from their posts. The list is replaced as a whole on update.                                                                                                                                                  |
| `default_domain`                     | enum                    |           | Default domain used for ticket filing. One of: `UNKNOWN_DOMAIN`, `IT_DOMAIN`, `HR_DOMAIN`, `FACILITY_DOMAIN`, `FINANCE_DOMAIN`, `LEGAL_DOMAIN`, `PAYROLL_DOMAIN`, `PROCUREMENT_DOMAIN`, … (14 values).                                                                                                        |
| `updated_time`                       | string                  |           | When the configuration was last updated.                                                                                                                                                                                                                                                                      |
| `updated_by`                         | string                  |           | Who last updated the configuration.                                                                                                                                                                                                                                                                           |
| `version`                            | Version                 | ✅         | Document version. On update, send back the num from your last read.                                                                                                                                                                                                                                           |

### Example create body

```json
{
  "slack_channel_name": "example-name",
  "slack_channel_id": "C0123456789",
  "domains_enabled": [],
  "skills_disabled": [],
  "subskills_disabled": [],
  "feedback_enabled_skills": [],
  "ticket_filing_disabled": true,
  "responding_to_agents_enabled": true,
  "handoff_when_no_response_enabled": true,
  "version": {
    "change_description": "Create channel resolver"
  }
}
```