Sign in

v1

latestOpenAPI 3.0.12026-07-26152262362.2 KB
Insights

List insights

Returns a paginated list of insights with their aggregate summaries (savings, risk counts). Use query parameters to filter by status, category, provider, or priority. Does not include individual resource-level results — use the resource-results endpoint for those.

get/insights/v1/results

Query parameters

searchTermstring

Free-text search term to filter insights by title or description.

displayStatusstring[]

Filter by one or more display statuses.

category'FinOps' | 'OperationalExcellence' | 'PerformanceEfficiency' | 'Reliability' | 'Security' | 'Sustainability'

Filter by insight category.

cloudProviderstring

The cloud provider associated with the resource.

Example:aws

Filter by cloud provider (e.g. "aws", "gcp", "azure").

sourceSource[]

the source that generated insights

[
  "aws-trusted-advisor, aws-cost-optimization-hub, aws-security-hub, azure-advisor, custom, gcp-recommender"
]
prioritystring[]

Filter by one or more priority levels.

tagstring[]

Filter by one or more tags (e.g. security certification labels like "ISO").

easyWinboolean

When true, return only insights flagged as easy wins.

cloudFlowsboolean

When true, return only insights that have associated CloudFlow automations.

pageTokenstring

Token from a previous response to fetch the next page.

maxResultsinteger

Maximum number of results per page (default 50, max 500).

Response

Successful operation

Example response

{
  "results": [
    {
      "source": "aws-trusted-advisor, aws-cost-optimization-hub, aws-security-hub, azure-advisor, custom, gcp-recommender",
      "cloudProvider": "aws",
      "lastStatusChange": {
        "userId": "/users/0Rkrkeq5P0XLe8QFHKq2"
      }
    }
  ]
}