API Reference Overview

View as Markdown

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:

APIDescription
Events APISend events to trigger automations and workflows
Conversations APICreate and manage conversation threads programmatically
(Beta) Conversations APIPrevious beta version (v1beta1)
Data APIQuery and manage data within the platform
Webhook ListenersReceive webhook events from external systems

Gateways (Customer-hosted)

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

GatewayDescription
Content GatewayServe content and documents to the AI
Identity GatewayResolve user identities across systems
Knowledge GatewayProvide knowledge base search results
Forms GatewayHandle form submissions and data collection

Authentication

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

$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 CenterBase URL
United States (default)https://api.moveworks.ai
Canadahttps://api.am-ca-central.moveworks.ai
EUhttps://api.am-eu-central.moveworks.ai
Australia / Asia Pacifichttps://api.am-ap-southeast.moveworks.ai
Government Secure Cloudhttps://api.moveworksgov.ai
Japanhttps://api.jp.moveworks.com
UKhttps://api.uk.moveworks.com
US Prod 4https://api.prod4.us.moveworks.com
US Prod 3https://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.