---
title: "POST /recommendations"
method: POST
path: "/recommendations"
---

# POST /recommendations

`POST /recommendations`

Returns a list of a specified insight's recommendations. Each recommendation includes a list of related metrics and a list of related events.

## Query parameters

- `NextToken` string

## Request body

- object
  - `InsightId` string, required — The ID of the requested insight.
  - `NextToken` string — The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
  - `Locale` 'DE_DE' | 'EN_US' | 'EN_GB' | 'ES_ES' | 'FR_FR' | 'IT_IT' | 'JA_JP' | 'KO_KR' | 'PT_BR' | 'ZH_CN' | 'ZH_TW' — A locale that specifies the language to use for recommendations.
  - `AccountId` string — The ID of the Amazon Web Services account.

## Response `200`

Success

- ListRecommendationsResponse
  - `Recommendations` Recommendation[] — An array of the requested recommendations.
    - `Description` string — A description of the problem.
    - `Link` string — A hyperlink to information to help you address the problem.
    - `Name` string — The name of the recommendation.
    - `Reason` string — The reason DevOps Guru flagged the anomalous behavior as a problem.
    - `RelatedEvents` RecommendationRelatedEvent[] — Events that are related to the problem. Use these events to learn more about what's happening and to help address the issue.
      - `Name` string — The name of the event. This corresponds to the <code>Name</code> field in an <code>Event</code> object.
      - `Resources` RecommendationRelatedEventResource[] — A <code>ResourceCollection</code> object that contains arrays of the names of Amazon Web Services CloudFormation stacks. You can specify up to 500 Amazon Web Services CloudFormation stacks.
        - `Name` string — The name of the resource that emitted the event. This corresponds to the <code>Name</code> field in an <code>EventResource</code> object.
        - `Type` string — The type of the resource that emitted the event. This corresponds to the <code>Type</code> field in an <code>EventResource</code> object.
    - `RelatedAnomalies` RecommendationRelatedAnomaly[] — Anomalies that are related to the problem. Use these Anomalies to learn more about what's happening and to help address the issue.
      - `Resources` RecommendationRelatedAnomalyResource[] — An array of objects that represent resources in which DevOps Guru detected anomalous behavior. Each object contains the name and type of the resource.
        - `Name` string — The name of the resource.
        - `Type` string — The type of the resource. Resource types take the same form that is used by Amazon Web Services CloudFormation resource type identifiers, <code>service-provider::service-name::data-type-name</code>. For example, <code>AWS::RDS::DBCluster</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services resource and property types reference</a> in the <i>Amazon Web Services CloudFormation User Guide</i>.
      - `SourceDetails` RecommendationRelatedAnomalySourceDetail[] — Information about where the anomalous behavior related the recommendation was found. For example, details in Amazon CloudWatch metrics.
        - `CloudWatchMetrics` RecommendationRelatedCloudWatchMetricsSourceDetail[] — An array of <code>CloudWatchMetricsDetail</code> objects that contains information about the analyzed metrics that displayed anomalous behavior.
          - `MetricName` string — The name of the CloudWatch metric.
          - `Namespace` string — The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
      - `AnomalyId` string — The ID of an anomaly that generated the insight with this recommendation.
    - `Category` string — The category type of the recommendation.
  - `NextToken` string — The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — ValidationException

---

[API](https://skmtc.net/aws/apis/devops-guru.md) · [All operations](https://skmtc.net/aws/apis/devops-guru/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/devops-guru/versions/0e960c150e92/schema)