> ## Documentation Index
> Fetch the complete documentation index at: https://developers.eyequant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate recommendations

> Trigger asynchronous generation of actionable design recommendations for an analysis.

Trigger asynchronous generation of recommendations — a set of concrete, actionable suggestions for improving the design. After triggering, poll [Get recommendations](/api-reference/get-recommendations) until `status` is `completed`. For richer recommendations, set context first with [Update analysis metadata](/api-reference/update-analysis-meta).

<Note>
  The `analysis-id` path parameter is the analysis id returned as `_internal_exposed_id` from [Get an analysis](/api-reference/get-analysis) — not the top-level `id` returned when you create an analysis.
</Note>

<ParamField path="analysis-id" type="string" required>
  The analysis id (`_internal_exposed_id` from Get an analysis).
</ParamField>

<ResponseField name="success" type="boolean">
  Whether the request was accepted.
</ResponseField>

<ResponseField name="status" type="string">
  Generation status: `started` or `processing`.
</ResponseField>

<ResponseField name="msg" type="string">
  Human-readable status message.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl \
    -X POST \
    -H "Authorization: Bearer $apikey" \
    https://api.eyequant.com/v2/analyses/recommendations/$analysisId
  ```

  ```javascript JavaScript theme={null}
  const baseUrl = 'https://api.eyequant.com/v2';

  const response = await fetch(`${baseUrl}/analyses/recommendations/${analysisId}`, {
    method: 'POST',
    headers: { Authorization: `Bearer ${apiKey}` },
  });

  const recommendationsStatus = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json started theme={null}
  {
    "success": true,
    "status": "started",
    "msg": "Recommendation generation started"
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "msg": "analysis_not_found"
  }
  ```
</ResponseExample>