{"note":"OpenAPI conversion -- returning structured metadata","name":"amazonaws-com-personalize-runtime","description":"Amazon Personalize Runtime","version":"2018-05-22","base_url":"","endpoints":3,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Amazon Personalize Runtime\n@version 2018-05-22\n@auth AWS SigV4\n@endpoints 3\n@toc action-recommendations(1), personalize-ranking(1), recommendations(1)\n\n@group action-recommendations\n@endpoint POST /action-recommendations\n@desc Returns a list of recommended actions in sorted in descending order by prediction score. Use the GetActionRecommendations API if you have a custom campaign that deploys a solution version trained with a PERSONALIZED_ACTIONS recipe.  For more information about PERSONALIZED_ACTIONS recipes, see PERSONALIZED_ACTIONS recipes. For more information about getting action recommendations, see Getting action recommendations.\n@optional {campaignArn: str, userId: str, numResults: int, filterArn: str, filterValues: map<str,str>}\n@returns(200) {actionList: [PredictedAction]?, recommendationId: str?}\n\n@endgroup\n\n@group personalize-ranking\n@endpoint POST /personalize-ranking\n@desc Re-ranks a list of recommended items for the given user. The first item in the list is deemed the most likely item to be of interest to the user.  The solution backing the campaign must have been created using a recipe of type PERSONALIZED_RANKING.\n@required {campaignArn: str, inputList: [str], userId: str}\n@optional {context: map<str,str>, filterArn: str, filterValues: map<str,str>, metadataColumns: map<str,[str]>}\n@returns(200) {personalizedRanking: [PredictedItem]?, recommendationId: str?}\n\n@endgroup\n\n@group recommendations\n@endpoint POST /recommendations\n@desc Returns a list of recommended items. For campaigns, the campaign's Amazon Resource Name (ARN) is required and the required user and item input depends on the recipe type used to create the solution backing the campaign as follows:   USER_PERSONALIZATION - userId required, itemId not used   RELATED_ITEMS - itemId required, userId not used    Campaigns that are backed by a solution created using a recipe of type PERSONALIZED_RANKING use the API.   For recommenders, the recommender's ARN is required and the required item and user input depends on the use case (domain-based recipe) backing the recommender. For information on use case requirements see Choosing recommender use cases.\n@optional {campaignArn: str, itemId: str, userId: str, numResults: int, context: map<str,str>, filterArn: str, filterValues: map<str,str>, recommenderArn: str, promotions: [Promotion], metadataColumns: map<str,[str]>}\n@returns(200) {itemList: [PredictedItem]?, recommendationId: str?}\n\n@endgroup\n\n@end\n"}