---
title: "Generate Remediation Insight"
method: POST
path: "/remediation/generate-insight"
---

# Generate Remediation Insight

`POST /remediation/generate-insight`

## Request

- Base URL: `https://emfirge.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://emfirge.cloud/remediation/generate-insight`
- Auth: none declared

Generate AI-powered 'What this fixes' and 'Why it matters' text for a single finding.
Rate limited to 5 requests/minute per IP.
Never errors beyond 429 — falls back to static text derived from the finding if Gemini fails.

## Query parameters

- `raw` boolean

## Request body

- RemediationInsightRequest
  - `rule_id` string, nullable
  - `severity` string, required
  - `issue` string, required
  - `recommendation` string, required
  - `resource_id` string, nullable
  - `region` string, nullable
  - `aws_service` string, required
  - `attack_path` string[], nullable
  - `account_id` string, nullable

## Response `200`

Successful Response

- RemediationInsightResponse
  - `what_this_fixes` string, required
  - `why_it_matters` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/emfirge/apis/aws-risk-analysis-agent.md) · [All operations](https://skmtc.dev/emfirge/apis/aws-risk-analysis-agent/llms.txt) · [OpenAPI document](https://skmtc.dev/emfirge/apis/aws-risk-analysis-agent/revisions/149a9263d07a?raw)