Skip to content
Ishvana Ishvana Docs

Ai Analyze Plot

POST
/api/creative/plot/analyze

Run Hawken plot analysis for the active project.

Request Body required

Section titled “Request Body required ”
AiAnalysisRequest

Request body for Hawken plot analysis.

object
plotlineId
Any of:
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

AiAnalysisResponse

Response wrapper for Hawken plot analysis.

object
status
Status

Operation status

string
default: ok
data
required
AiAnalysisData

Hawken analysis payload

object
insights
Insights
Array<object>
AiInsight

A single Hawken insight about the plot.

object
area
required
Area

Area of analysis

string
insight
required
Insight

The insight or suggestion

string
severity
required
Severity

Severity level

string
Allowed values: strength suggestion concern
summary
Summary

High-level summary

string
""
modelUsed
Modelused

Handler or ruleset that produced the analysis

string
""

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object