Skip to main content

Ask the AI agent builder and get the full reply

POST 
https://platform.docana.com/api/v1/agents/builder/ask/

Converse with Docana's agent-building expert without streaming: send one message, receive the complete reply. Use it to ask design questions (node types, transitions, platform gotchas) even when authoring a spec yourself, or to delegate the build — when the builder creates or edits a spec, the response carries the persisted artifact (id, version, spec) alongside the reply. On follow-up requests pass the returned threadId (to continue the conversation) and artifact.id as artifactId (so the builder edits that spec instead of creating a new one). Replies can take a minute or two for complex requests; clients that can consume a stream may prefer runAgentBuilder.

Request​

Responses​

The builder's reply and the conversation thread id.