v2

latestOpenAPI 3.1.02026-08-08556285514.3 KB
AgentChat

Post Canvas Intent

Forward a canvas gesture to the Kirbi Manager Agent.

The agent receives the intent as a coordinator-tagged run; it has access to get_workflow_state and update_workflow tools so it can decide whether/how to mutate the workflow. The frontend listens on the existing /workflows/{id}/events/stream SSE channel for workflow_updated events to refresh the canvas.

Returns the runtime's run id so the caller can subscribe to its stream via GET /api/agent-chat/runs/{run_id}/stream.

post/api/agent-chat/workflows/{workflow_id}/canvas-intent

Path parameters

workflow_idstring required

Request body

kindstring required
payloadobject
user_facing_summarystring nullable
modelstring nullable

Response

Successful Response

{"stackTrail":"paths:/api/agent-chat/workflows/{workflow_id}/canvas-intent:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}