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

# Conversations API

## Docs

- [Conversations API overview](https://docs.moveworks.com/api-reference/conversations-api/overview.md): The Moveworks Conversations API lets your application create conversations with the assistant, send messages on behalf of your users, and receive responses over polling or streaming.
- [Create the Conversations API chatbot](https://docs.moveworks.com/api-reference/conversations-api/create-the-chatbot.md): Create the chatbot entry that represents your Conversations API integration and produces the Bot Name you send in the Assistant-Name header.
- [Set up authentication with Okta](https://docs.moveworks.com/api-reference/conversations-api/set-up-authentication-with-okta.md): Configure Okta to authenticate against the Moveworks Conversations API using a JWT OAuth credential.
- [Set up authentication with Azure AD (Entra ID)](https://docs.moveworks.com/api-reference/conversations-api/set-up-authentication-with-azure-ad-entra-id.md): Configure Azure AD (Entra ID) to authenticate against the Moveworks Conversations API, using Issuer + Audience and the oid claim for identity resolution.
- [Set up service-to-service authentication](https://docs.moveworks.com/api-reference/conversations-api/set-up-service-to-service-authentication.md): Authenticate a backend service to the Moveworks Conversations API using a self-signed JWT bearer, letting your service make requests on behalf of any provisioned user.
- [Proactive notifications overview](https://docs.moveworks.com/api-reference/conversations-api/proactive-notifications/overview.md): Understand how system-initiated messages are delivered to Conversations API integrations: architecture, routing behavior, and current limitations.
- [Receive proactive notifications via polling](https://docs.moveworks.com/api-reference/conversations-api/proactive-notifications/receive-via-polling.md): Retrieve system-initiated messages by polling the Conversations API events endpoint with a per-user checkpoint.
- [Receive proactive notifications via outbound webhook](https://docs.moveworks.com/api-reference/conversations-api/proactive-notifications/receive-via-outbound-webhook.md): Receive push notifications from Moveworks when a new system-initiated message is available, and reconcile content via the events endpoint.

## API Docs

- Conversations API > Conversations [List conversations](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/conversations/list-conversations.md)
- Conversations API > Conversations [Create conversation](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/conversations/create-conversation.md)
- Conversations API > Conversations [Get conversation](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/conversations/get-conversation.md)
- Conversations API > Conversations [Update conversation](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/conversations/update-conversation.md)
- Conversations API > Conversations [List conversation events](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/conversations/list-events.md)
- Conversations API > Conversations [Get conversation event](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/conversations/get-event.md)
- Conversations API > Responses [Create response](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/responses/create-response.md)
- Conversations API > Responses [Create response (streaming)](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/responses/create-response-stream.md)
- Conversations API > Responses [Get response](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/responses/get-response.md)
- Conversations API > Messages [List conversation messages](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/messages/list-conversation-messages.md)
- Conversations API > Messages [List response messages](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/messages/list-response-messages.md)
- Conversations API > Messages [Submit feedback](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/messages/submit-feedback.md)
- Conversations API > Modals [Get modal](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/modals/get-modal.md)
- Conversations API > Modals [Refresh modal](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/modals/refresh-modal.md)
- Conversations API > Modals [Submit modal](https://docs.moveworks.com/api-reference/conversations-api/conversations-api/modals/submit-modal.md)
- (Deprecated) Conversations API > Conversations [List conversations](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/conversations/list-conversations.md)
- (Deprecated) Conversations API > Conversations [Create conversation](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/conversations/create-conversation.md)
- (Deprecated) Conversations API > Conversations [Get conversation](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/conversations/get-conversation.md)
- (Deprecated) Conversations API > Conversations [Update conversation](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/conversations/update-conversation.md)
- (Deprecated) Conversations API > Conversations [List conversation events](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/conversations/list-events.md)
- (Deprecated) Conversations API > Responses [Create response](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/responses/create-response.md)
- (Deprecated) Conversations API > Responses [Create response (streaming)](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/responses/create-response-stream.md)
- (Deprecated) Conversations API > Responses [Get response](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/responses/get-response.md)
- (Deprecated) Conversations API > Messages [List conversation messages](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/messages/list-conversation-messages.md)
- (Deprecated) Conversations API > Messages [List response messages](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/messages/list-response-messages.md)
- (Deprecated) Conversations API > Messages [Submit feedback](https://docs.moveworks.com/api-reference/conversations-api/deprecated-conversations-api/messages/submit-feedback.md)
- (Beta) Conversations API > Conversations [List conversations](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/conversations/list-conversations.md)
- (Beta) Conversations API > Conversations [Create conversation](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/conversations/create-conversation.md)
- (Beta) Conversations API > Conversations [Get conversation](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/conversations/get-conversation.md)
- (Beta) Conversations API > Conversations [Update conversation](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/conversations/update-conversation.md)
- (Beta) Conversations API > Conversations [List conversation events](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/conversations/list-events.md)
- (Beta) Conversations API > Responses [Create response](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/responses/create-response.md)
- (Beta) Conversations API > Responses [Create response (streaming)](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/responses/create-response-stream.md)
- (Beta) Conversations API > Responses [Get response](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/responses/get-response.md)
- (Beta) Conversations API > Messages [List conversation messages](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/messages/list-conversation-messages.md)
- (Beta) Conversations API > Messages [List response messages](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/messages/list-response-messages.md)
- (Beta) Conversations API > Messages [Submit feedback](https://docs.moveworks.com/api-reference/conversations-api/beta-conversations-api/messages/submit-feedback.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.moveworks.com/api-reference/conversations-api/openapi.json)
- [OpenAPI YAML](https://docs.moveworks.com/api-reference/conversations-api/openapi.yaml)