Skip to documentation
Workflow Developer API

Update Developer Workflow

Update workflow metadata or an existing draft; published graphs are immutable.

PATCH/developer/v1/workflows/{definition_id}

Authorizations

Authorization
stringheaderrequired

Send your GenHealth credential as Bearer <YOUR_API_KEY>. This endpoint requires workflow:write for the authenticated organization. When body.status is set, workflow:publish is also required.

Headers

Accept
stringheader

Response media type. Use application/json for the current API.

Parameters

definition_idrequired
stringpath

Request body

Send an application/json request body. This body is required.

WorkflowDeveloperDefinitionUpdate
namestring | null
descriptionstring | null
statusstring | null
nodesarray<WorkflowNodeSchema> | null
edgesarray<WorkflowEdgeSchema> | null
triggerobject<string, any> | null
configobject<string, any> | null
routestring | null

Responses

200Successful Response
WorkflowDefinitionResponse
idstring
org_idstring
namestring
descriptionstring | null
statusstring
nodesarray<WorkflowNodeSchema>
edgesarray<WorkflowEdgeSchema>
triggerobject<string, any> | null
422Validation Error
HTTPValidationError
detailarray<ValidationError>