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

Moveworks messages API

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

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

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

This API exposes 3 operations across 3 paths, and defines 53 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.

3 operations 3 paths 53 schemas 2 GET1 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 messages 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 3

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

messages 3
GET
/conversations/{conversation_id}/messages
List conversation messages
list-conversation-messages 5 params → 200400401403404429500
GET
/conversations/{conversation_id}/responses/{response_id}/messages
List response messages
list-response-messages 4 params → 200401403404429500
POST
/conversations/{conversation_id}/responses/{response_id}/messages/{message_id}/feedback
Submit feedback
submit-feedback 5 params body → 200400404429500

Schemas 53

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

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
InvalidFeedbackErrorResponseErrorCode
string
ActorType
string
Message actor type
FeedbackOption
object
1 property 1 required
Citation
object
4 properties
PlainTextContentItemType
string
Content type discriminator
UnauthorizedErrorResponse
object
Error response for unauthorized access
1 property 1 required
UnauthorizedErrorResponseErrorCode
string
Message
object
9 properties 6 required
ListResponseMessagesResponse
object
1 property 1 required
CitationContentReference
object
2 properties 2 required
CommonmarkTextContentItemType
string
Content type discriminator
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
InvalidFeedbackErrorResponseError
object
2 properties 2 required
InternalErrorResponseErrorCode
string
InternalErrorResponse
object
Error response for internal server error
1 property 1 required
SubmitFeedbackResponse
object
1 property 1 required
Metadata
object
1 property
SubmitFeedbackRequest
object
2 properties 1 required
UnauthorizedErrorResponseError
object
2 properties 2 required
NotFoundErrorResponse
object
Error response for resource not found
1 property 1 required
ListConversationMessagesResponse
object
2 properties 1 required
InternalErrorResponseError
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
ForbiddenErrorResponseError
object
2 properties 2 required
Content
Message content with type discriminator
NotFoundErrorResponseError
object
2 properties 2 required
RateLimitExceededErrorResponseErrorCode
string
InvalidFeedbackErrorResponse
object
Error response for invalid feedback submission
1 property 1 required
MarkdownTextContentItemType
string
Content type discriminator
SubmitFeedbackResponseStatus
string
Feedback submission status
RateLimitExceededErrorResponseError
object
2 properties 2 required
InvalidCursorErrorResponse
object
Error response for invalid pagination cursor
1 property 1 required
CommonmarkTextContent
object
1 property 1 required
RateLimitExceededErrorResponse
object
Error response for rate limit exceeded
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

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

moveworks-messages-api-openapi.yml Raw ↑

Other APIs Moveworks publishes across the network.

Moveworks authentication API
Moveworks conversations API
Moveworks Default API
Moveworks deprecated API
Moveworks events API
Moveworks responses API
Moveworks smartForms API
Moveworks webhooks API
Where this information came from

This is an independent, third-party profile of Moveworks messages 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.