Skip to main content
The recommendations endpoints expose InfraAudit’s Gemini-powered suggestions for cost savings, security improvements, and performance optimisations. Recommendations are generated per resource and include estimated monthly savings where applicable. Base path: /api/v1/recommendations

GET /recommendations — list recommendations

Returns a paginated list of recommendations across all resources.

Query parameters

type
string
Filter by recommendation type: cost, security, or performance.
status
string
Filter by status: pending, applied, or dismissed.
resource_id
integer
Filter by resource.
provider_id
integer
Filter by provider.
page
integer
default:"1"
Page number.
per_page
integer
default:"20"
Results per page. Maximum is 100.

Response

estimated_monthly_savings
number
Estimated monthly cost savings in USD. Present only for cost type recommendations.

GET /recommendations/ — get recommendation

Returns full recommendation details including step-by-step remediation instructions.

POST /recommendations/generate — generate recommendation

Generates a new AI recommendation for a specific resource, or updates an existing pending one.

Request body

resource_id
integer
required
The resource to generate a recommendation for.

POST /recommendations//apply — apply recommendation

Marks a recommendation as applied and optionally creates a remediation action.

POST /recommendations//dismiss — dismiss recommendation

Dismisses a recommendation with an optional reason.

Request body (optional)

reason
string
Explanation for dismissing this recommendation.