responses

Create response

Creates a response object for processing. Returns immediately with the response object. Use GetResponse by response_id to poll for the complete result.

If the conversation is handed off to live chat, the turn is relayed to the human agent rather than the assistant, so the response is returned already COMPLETED with no output items. The agent's reply arrives separately, as a LIVE_AGENT message on a response of its own, and is received like a proactive notification, by webhook push or by polling the events endpoint. Unlike other system-initiated messages it always arrives on this conversation, since a live chat is bound to the one it was started in.

post/conversations/{conversation_id}/responses

Request

  • Base URL: https://api.moveworks.ai/rest/v1
  • URL: https://api.moveworks.ai/rest/v1/conversations/{conversation_id}/responses
  • Auth: HTTP bearer

Path parameters

conversation_idstring required

A base-62 identifier prefixed by a short resource type

Headers

Assistant-Namestring required

The Moveworks assistant identifier that was configured for your organization.

Request body

Response

Response accepted for processing (acknowledgement)

response_idstring required

A base-62 identifier prefixed by a short resource type

conversation_idstring required

A base-62 identifier prefixed by a short resource type

status'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' required

Response processing status

created_atstring date-time required

Creation timestamp (ISO 8601)

completed_atstring date-time nullable

Completion timestamp (ISO 8601), null if not completed

Changes

No recorded changes to this operation across all 1 revision of this API.