Ask Hawken
POST /api/creative/hawken/chat
Dispatch a command to Hawken’s deterministic DE surfaces.
Supported command prefixes: classify task: <prompt>,
classify audience: <prompt>, resolve style: <prompt>,
scan scene: <scene_id>, research: <prompt>, lore: <query>,
help. Unknown input returns the help catalogue.
Request Body required
Section titled “Request Body required ”Request body for freeform agent chat across core conversational agents.
object
User’s freeform message to the agent
Prior conversation turns. Capped at 50 so the prompt stays bounded — older turns are dropped by the caller.
A single turn in a freeform agent conversation history.
object
Message role (user or assistant)
Message content
Ambient author context attached to a freeform agent request.
Responses
Section titled “ Responses ”Successful Response
Response from agent freeform chat interaction.
object
Agent’s response text
A single tool invocation Lagan made during a freeform chat turn.
Richer than a bare tool name — the UI can show arguments (so the author sees what Lagan searched for) and, when the agent reports it, a short preview of the result the tool returned.
Validation Error