# POST /apps/{appId}/insight-analyses/actions/recommend

Returns analysis recommendations in response to a natural language question, a set of fields and master items, or a set of fields and master items with an optional target analysis.

## Path parameters

| Name | Description | Type |
| --- | --- | --- |
| appId | Qlik Sense app identifier | String (uid) |
| accept-language | language specified as an ISO-639-1 code. Defaults to 'en' (English). | String |

## Request Body

| Name | Type |  |
| --- | --- | --- |
| Request payload can be of two types, using natural language query or consist of fields or master items and optional target analysis.<br>In below examples, consider sales as a master item and product as field, so to get recommendations using sales and product,<br>you can utilize below three approaches, also you can set language parameter in headers as part of accept-language.<br>Examples:<br>```<br>{<br>'text': 'show me sales by product'<br>}<br>```<br>```<br>{<br>'fields': [<br>{<br>'name': 'product'<br>}<br>],<br>'libItems': [<br>{<br>libId: 'NwQfJ'<br>}<br>]<br>}<br>```<br>```<br>{<br>'fields': [<br>{<br>'name': 'product'<br>}<br>],<br>'libItems': [<br>{<br>'libId': 'NwQfJ'<br>}<br>],<br>'targetAnalysis': {<br>'id': 'rank-rank'<br>}<br>}<br>``` | [AnalysisRecommendRequest](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-analysisrecommendrequest.htm) | Required |

## Responses

| Name | Description | Type |
| --- | --- | --- |
| 200 | The request is successfully processed and recommendations are returned. | [AnalysisRecommendationResponse](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-analysisrecommendationresponse.htm) |
| 400 | Bad request. The payload is not formed correctly. | [Errors](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-errors.htm) |
| 401 | User is not authorized | [Errors](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-errors.htm) |
| 404 | Not found | [Errors](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-errors.htm) |
| 409 | Invalid Business Logic | [Errors](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-errors.htm) |
| 422 | Unprocessable entity. The payload contains fields<br>that are invalid, such as too long of a query. | [Errors](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-errors.htm) |
| 500 | Internal server error | [Errors](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NLBrokerAPI/Content/models-errors.htm) |