v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1441225191.1 KB

Retrieves recommendations for the specified session. To avoid retrieving the same recommendations in subsequent calls, use <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_NotifyRecommendationsReceived.html">NotifyRecommendationsReceived</a>. This API supports long-polling behavior with the <code>waitTimeSeconds</code> parameter. Short poll is the default behavior and only returns recommendations already available. To perform a manual query against an assistant, use <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_QueryAssistant.html">QueryAssistant</a>.

get/assistants/{assistantId}/sessions/{sessionId}/recommendations

Path parameters

assistantIdstring required

The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.

sessionIdstring required

The identifier of the session. Can be either the ID or the ARN. URLs cannot contain the ARN.

Query parameters

maxResultsinteger

The maximum number of results to return per page.

waitTimeSecondsinteger

The duration (in seconds) for which the call waits for a recommendation to be made available before returning. If a recommendation is available, the call returns sooner than <code>WaitTimeSeconds</code>. If no messages are available and the wait time expires, the call returns successfully with an empty list.

Response

Success