---
title: "Generate recommendations"
method: POST
path: "/api/v1/analysis/{uuid}/recommendations"
tags: ["Analysis"]
---

# Generate recommendations

`POST /api/v1/analysis/{uuid}/recommendations`

## Request

- Base URL: `https://botsee.io`
- URL: `https://botsee.io/api/v1/analysis/{uuid}/recommendations`
- Auth: HTTP bearer

Generates actionable recommendations from the analysis (cached after first call). Costs credits based on LLM token usage on the first call; subsequent calls return the cached result at no cost.

## Path parameters

- `uuid` string, required

## Response `201`

Resource created.

- object
  - `cached` boolean
  - `credits_used` integer
  - `generated_at` string
  - `recommendations` object[]
    - `action` string
    - `priority` string
    - `reasoning` string
    - `target_keywords` string[]

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but lacks permission (e.g. botsee_disabled).
- `404`: The requested resource does not exist or is not accessible.
- `422`: Request body or parameters failed validation.
- `429`: Too many requests. Wait and retry per Retry-After header.

---

[API](https://skmtc.dev/botsee/apis/botsee-api.md) · [All operations](https://skmtc.dev/botsee/apis/botsee-api/llms.txt) · [OpenAPI document](https://skmtc.dev/botsee/apis/botsee-api/revisions/f815b844e73b?raw)
