Ask the AI agent builder and get the full reply
POSThttps://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
- 200
- 400
- 401
- 403
- 500
- 502
The builder's reply and the conversation thread id.
Invalid body.
The API key or session is missing, expired, or malformed.
The caller is authenticated but not allowed to perform this operation.
Unexpected server error.
The builder run failed.