Generate an Agent
Create an inbound agent and its first flow from a prompt.
POST
Generate an agent from a prompt
Starts asynchronous generation of a new inbound agent and its first flow from a natural-language prompt.
Send a unique
Idempotency-Key with every logical request. Repeating the same request with the same key returns the existing generation instead of creating another agent. Reusing the key with different request data returns an idempotency conflict.
The initial response includes a generationId and a Location header. Poll that location until the status is completed or failed.
Generation statuses
Only users with permission to edit agent design in the selected organization can generate an agent.
Authorizations
Headers
A unique key for this logical generation request. Maximum 128 characters.
Required string length:
1 - 128Body
application/json
Organization in which to create the agent
Required string length:
1 - 128Name for the generated agent
Required string length:
1 - 50Valid IANA timezone. Defaults to UTC.
Required string length:
1 - 64Example:
"America/New_York"
Response
The idempotent request already completed
Pattern:
^gen_[a-f0-9]{40}$Available options:
queued, generating, completed, failed Generated agent identifier. Present when status is completed.
Generated first-flow identifier. Present when status is completed.
Last modified on August 4, 2026
Generate an agent from a prompt

