---
title: "POST /tracer/imagine-analysis/"
method: POST
path: "/tracer/imagine-analysis/"
tags: ["tracer"]
---

# POST /tracer/imagine-analysis/

`POST /tracer/imagine-analysis/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/imagine-analysis/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Trigger analysis for widgets. Creates DB records + starts Temporal workflows.

## Request body

- TriggerAnalysis
  - `saved_view_id` string, uuid, required
  - `trace_id` string, required
  - `project_id` string, uuid, required
  - `widgets` WidgetAnalysis[], required
    - `widget_id` string, required
    - `prompt` string, required

## Response `200`

OK

- ImagineAnalysisResponse
  - `status` boolean
  - `result` ImagineAnalysisResult, required
    - `analyses` ImagineAnalysisItem[], required
      - `id` string, uuid, required
      - `widget_id` string, required
      - `status` 'pending' | 'running' | 'completed' | 'failed', required
      - `content` string, nullable
      - `error` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)