Skip to main content
POST
Create workflow (agent)

Authorizations

x-api-key
string
header
required

Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key:

Headers

x-username
string
default:(project default user)

External user (end user) to act as. Optional — if omitted, Flowra uses the project’s default external user. Send a stable username (e.g. customer_alice) only when you need another end-user context.

Body

application/json
name
string
default:New Agent

Agent name

Example:

"Support bot"

description
string

Agent description

Example:

"Answers product questions and escalates billing issues."

isPublic
boolean
default:false

Whether this agent is public (visible in other projects’ agent select)

Example:

false

agent
object
triggers
object[]

Optional cron / channel event triggers (0..N). Dashboard chat is always available.

provenance
object

Response

200 - application/json

Agent created successfully

success
boolean
required

Success status

Example:

true

message
string
required

Success message

Example:

"Operation completed successfully"

data
object
required
Example: