Flow AgentsVersion: v3
Create Agent
POST/agent-studio/agent
Creates a new agent with staging version. The agent will be created with an initial staging version that can later be promoted to production.
Authorizations
Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
Scope:
agent-studio.Auth methods:
OAuthPrivate IntegrationToken type:
Sub-Account TokenRequest
Headers
Versionstringrequired
API Version
Available options
v3Example:
v3Query Parameters
sourcestring
Origin channel attributed to this write for auditing (e.g. public_api, internal)
Example:
apiBody
locationIdstringrequired
Location ID
Example:
C2QujeCh8ZnC7al2InWRnamestring
Name of the agent
Example:
Customer Support Agentdescriptionstring
Description of the agent
Example:
AI agent specialized in handling customer inquiries and support ticketsagencyIdstring
Agency ID
Example:
gjL2sFNXJfJYa3d2OYSNauthorIdstring
Author ID
Example:
usr_abc123def456authorNamestring
Author name
Example:
John Doestatusstringrequired
Status of the agent
Available options
activeinactivearchivedExample:
activeversionobjectrequired
Version data for the agent including nodes, edges, and configuration
nodesstring[]
Nodes array (deprecated, prefer using version.nodes)
Example:
[]edgesstring[]
Edges array (deprecated, prefer using version.edges)
Example:
[]Response
Agent created successfully
successbooleanrequired
Success status
Example:
truemessagestringrequired
Response message
Example:
Agent created successfully with staging version.agentobjectrequired
Created agent data with metadata
versionsarrayrequired
Created versions array (initial staging version)