Skip to main content
PATCH
Update workflow

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.

Path Parameters

id
string
required

Workflow (agent) ID

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Body

application/json
name
string

Workflow display name

Example:

"Support bot"

description
string

Short description shown in the workflow list

Example:

"Answers product questions and escalates billing issues."

agent
object
graph
object
provenance
object
triggers
object[]

Replace cron / channel triggers. Empty array clears them.

workflowType
enum<string>

agent is an open LLM path; static is a locked graph

Available options:
static,
agent
Example:

"agent"

isActive
boolean

Whether the workflow is active (cron/webhooks fire only when true)

Example:

true

isPublic
boolean

Whether other projects can select this agent

Example:

false

lastExecutedAt
string<date-time>

Last execution timestamp (ISO 8601). Usually set by the server.

Example:

"2026-09-03T10:00:00.000Z"

Response

200 - application/json

Workflow updated successfully

success
boolean
required

Success status

Example:

true

message
string
required

Success message

Example:

"Operation completed successfully"

data
object
required
Example: