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

# API Reference Overview

> REST APIs for integrating with Moveworks

# API Reference

Moveworks provides REST APIs to integrate AI-powered automation into your applications and workflows.

## API Categories

### Core APIs (Moveworks-hosted)

These APIs are hosted by Moveworks and allow you to send data and interact with the platform:

| API                          | Description                                             |
| ---------------------------- | ------------------------------------------------------- |
| **Events API**               | Send events to trigger automations and workflows        |
| **Conversations API**        | Create and manage conversation threads programmatically |
| **(Beta) Conversations API** | Previous beta version (`v1beta1`)                       |
| **Data API**                 | Query and manage data within the platform               |
| **Webhook Listeners**        | Receive webhook events from external systems            |

### Gateways (Customer-hosted)

These APIs are implemented by customers to provide data to Moveworks:

| Gateway               | Description                                 |
| --------------------- | ------------------------------------------- |
| **Content Gateway**   | Serve content and documents to the AI       |
| **Identity Gateway**  | Resolve user identities across systems      |
| **Knowledge Gateway** | Provide knowledge base search results       |
| **Forms Gateway**     | Handle form submissions and data collection |

## Authentication

All APIs use Bearer token authentication. Include your API key in the `Authorization` header:

```bash
curl -X GET "https://api.moveworks.ai/assistant/v1/conversations" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Base URLs

The Moveworks API is hosted per data center. Every API request must go to the base URL for the data center your org is on — `https://api.moveworks.ai` only serves US Production. Sending requests to the wrong host returns 404 or `invalid_audience` errors, even if your token is otherwise valid.

| Data Center              | Base URL                                   |
| ------------------------ | ------------------------------------------ |
| United States (default)  | `https://api.moveworks.ai`                 |
| Canada                   | `https://api.am-ca-central.moveworks.ai`   |
| EU                       | `https://api.am-eu-central.moveworks.ai`   |
| Australia / Asia Pacific | `https://api.am-ap-southeast.moveworks.ai` |
| Government Secure Cloud  | `https://api.moveworksgov.ai`              |
| Japan                    | `https://api.jp.moveworks.com`             |
| UK                       | `https://api.uk.moveworks.com`             |
| US Prod 4                | `https://api.prod4.us.moveworks.com`       |
| US Prod 3                | `https://api.prod3.us.moveworks.com`       |

If you're not sure which data center your org is on, or your org is on a data center not listed above, contact your Moveworks account team for the correct base URL before making API calls.

## Rate Limits

API requests are rate limited to ensure platform stability. Contact support for rate limit increases.