How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Moveworks

Moveworks conversations API

The conversations API from Moveworks — 3 operation(s) for conversations.

Documentation Provider Profile APIs.io OpenAPI GitHub

Moveworks conversations API is one of 9 APIs that Moveworks publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Conversations. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 3 paths, and defines 57 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 6 base URLs: https://api.moveworks.ai/rest/v1beta1, https://api.jp.moveworks.com/rest/v1beta1, https://api.uk.moveworks.com/rest/v1beta1, https://api.prod4.us.moveworks.com/rest/v1beta1, https://api.prod3.us.moveworks.com/rest/v1beta1, https://api.moveworks.ai/assistant/v1.

5 operations 3 paths 57 schemas 3 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.moveworks.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Moveworks conversations API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth).

  • BearerAuth — JWT bearer token authentication. Obtain an access token from the Moveworks auth endpoint and include it in the Authorization header as 'Bearer '.

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 3 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

conversations 5
GET
/conversations
List conversations
list-conversations 5 params → 200400401403429500
POST
/conversations
Create conversation
create-conversation 2 params body → 201400401403429500
GET
/conversations/{conversation_id}
Get conversation
get-conversation 3 params → 200401403404429500
PATCH
/conversations/{conversation_id}
Update conversation
update-conversation 3 params body → 200400401403404429500
GET
/conversations/{conversation_id}/events
List conversation events
list-events 7 params → 200401404429500

Schemas 57

The contract defines 57 schemas that model the data the API accepts and returns. The most detailed are Message_2 (10 properties), Message (9 properties), Conversation (5 properties), Citation (4 properties). Each schema is shown below with its type and property counts.

CreateConversationRequest
object
1 property
CitationLocation
object
Deprecated: Use Message.contentreferences for positional data instead. This field will no longer be populated starting May 12, 2026 for both new and existing m…
1 property
MarkdownTextContent
object
1 property 1 required
ForbiddenErrorResponseErrorCode
string
Display
object
3 properties
EventType
string
Event type discriminator for event payloads.
ListEventsResponse
object
2 properties 2 required
UpdateConversationRequest
object
2 properties
ActorType
string
Message actor type
FeedbackOption
object
1 property 1 required
Citation
object
4 properties
EventPayload
object
Event payload. Currently only message events are supported.
2 properties 1 required
PlainTextContentItemType
string
Content type discriminator
InvalidTitleErrorResponse
object
Error response for invalid conversation title
1 property 1 required
UnauthorizedErrorResponse
object
Error response for unauthorized access
1 property 1 required
UnauthorizedErrorResponseErrorCode
string
Message
object
9 properties 6 required
CommonmarkTextContentItemType
string
Content type discriminator
CitationContentReference
object
2 properties 2 required
InvalidCursorErrorResponseError
object
2 properties 2 required
ForbiddenErrorResponse
object
Error response for forbidden access
1 property 1 required
MessageFeedback
object
Feedback options available on an assistant message. When present, this message supports feedback and the callback IDs can be used to submit a rating.
2 properties
InternalErrorResponseErrorCode
string
InternalErrorResponse
object
Error response for internal server error
1 property 1 required
Metadata
object
1 property
InternalErrorResponseError
object
2 properties 2 required
UnauthorizedErrorResponseError
object
2 properties 2 required
NotFoundErrorResponse
object
Error response for resource not found
1 property 1 required
ForbiddenErrorResponseError
object
2 properties 2 required
Attribute
object
Key-value pair for citation display metadata. This is an opaque structure that contains rendering hints specific to each citation. Clients should not make assu…
2 properties 2 required
Content
Message content with type discriminator
Event
object
3 properties 3 required
NotFoundErrorResponseError
object
2 properties 2 required
Conversation
object
5 properties 3 required
RateLimitExceededErrorResponseErrorCode
string
MarkdownTextContentItemType
string
Content type discriminator
ListConversationsResponse
object
2 properties 1 required
RateLimitExceededErrorResponseError
object
2 properties 2 required
InvalidTitleErrorResponseErrorCode
string
InvalidTitleErrorResponseError
object
2 properties 2 required
CommonmarkTextContent
object
1 property 1 required
RateLimitExceededErrorResponse
object
Error response for rate limit exceeded
1 property 1 required
InvalidCursorErrorResponse
object
Error response for invalid pagination cursor
1 property 1 required
InvalidCursorErrorResponseErrorCode
string
NotFoundErrorResponseErrorCode
string
PlainTextContent
object
1 property 1 required
URLAction
object
1 property 1 required
UrlActionItemType
string
Action type discriminator
CallbackActionContent
object
1 property 1 required
Citation_2
object
3 properties
Message_2
object
10 properties 6 required
CallbackActionContentItemType
string
Content type discriminator
Action
An action a user can take in response to a message. The type field determines which action payload is present.
CallbackAction
object
1 property 1 required
CallbackActionItemType
string
Action type discriminator
Content_2
Message content with type discriminator
Event_2
object
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

moveworks-conversations-api-openapi.yml Raw ↑

Other APIs Moveworks publishes across the network.

Moveworks authentication API
AE Profile APIs.io
Moveworks Default API
AE Profile APIs.io
Moveworks deprecated API
AE Profile APIs.io
Moveworks events API
AE Profile APIs.io
Moveworks messages API
AE Profile APIs.io
Moveworks responses API
AE Profile APIs.io
Moveworks smartForms API
AE Profile APIs.io
Moveworks webhooks API
AE Profile APIs.io
#Conversations
← Back to M APIs
API Details
ID
moveworks:moveworks-conversations-api
Base URL
https://api.moveworks.ai
Docs
https://docs.moveworks.com/api-reference/events-api/events-api
Provider
Moveworks
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=moveworks-conversations-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/moveworks-conversations-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Moveworks conversations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.