v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1435190156.6 KB

Starts a new session for an Amazon Q App, allowing inputs to be provided and the app to be run.

Each Q App session will be condensed into a single conversation in the web experience.

post/runtime.startQAppSession#instance-id

Headers

instance-idstring required

The unique identifier of the Amazon Q Business application environment instance.

Request body

appIdstring required

The unique identifier of the Q App to start a session for.

appVersioninteger required

The version of the Q App to use for the session.

sessionIdstring

The unique identifier of the a Q App session.

tagsobject

Optional tags to associate with the new Q App session.

Response

Success

sessionIdstring required

The unique identifier of the new or retrieved Q App session.

sessionArnstring required

The Amazon Resource Name (ARN) of the new Q App session.