Skip to main content
PATCH
Update a workflow (partial)

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Path Parameters

id
string
required

The caller's own workflow on the current twin (anything else is 404).

Body

application/json
name
string
Maximum string length: 120
instruction
string
Maximum string length: 32000
enabled
boolean
model
string

'' (Default) or an id in the caller's current GET /workflow-models menu; anything else is 400 MODEL_NOT_AVAILABLE.

Maximum string length: 120
reasoning
enum<string>
Available options:
,
off,
low,
medium,
high,
xhigh
schedule
object

When a workflow runs, in its own IANA timezone (wall-clock: a daily 09:00 stays 09:00 across daylight saving). Only the fields of its kind are read; unknown fields are dropped. A time that does not exist on a spring-forward day fires at the first valid minute after it; a repeated time on a fall-back day fires once, at the earlier instant.

Response

{ success, workflow }

success
boolean
workflow
object

An agentsv2 workflow — its own collection, nothing shared with the v1 workflows under /api/user/agents/workflows. A run starts a new session in the owner's daemon for this twin with the instruction as its first prompt, and ends when streaming ends.