Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1494674591.3 KB

Submits a message to the Amazon Q in Connect session.

post/assistants/{assistantId}/sessions/{sessionId}/message

Path parameters

assistantIdstring required

The identifier of the Amazon Q in Connect assistant.

sessionIdstring required

The identifier of the Amazon Q in Connect session.

Request body

type'TEXT' | 'TOOL_USE_RESULT' required

The message type.

aiAgentIdstring

The identifier of the AI Agent to use for processing the message.

clientTokenstring

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the AWS SDK populates this field.For more information about idempotency, see Making retries safe with idempotent APIs.

orchestratorUseCasestring

The orchestrator use case for message processing.

metadataobject

Additional metadata for the message.

originRequestIdstring

Request identifier from the origin system, used for end-to-end tracing across spans.

Response

Success

requestMessageIdstring required

The identifier of the submitted message.

nextMessageTokenstring required

The token for the next message, used by GetNextMessage.