apiDeterministic
Update workflow
PUT /api/agent-workflows/{workflowId}
Update an existing workflow. Pass any subset of name, description, workflow_definition, or status. workflow_definition is the full DAG object (nodes + edges + variables) - typically produced by compile-workflow-from-prompt. Returns the updated workflow record.
Parameters
workspaceId
string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
workflowIdrequired
string
Workflow UUID to update.
name
string
No description.
description
string
No description.
workflow_definition
object
Full WorkflowDefinition DAG. Typically supplied verbatim from the compile-workflow-from-prompt response.
status
string
Optional status transition.
draft | active | paused | archived
Example
REST requestbash
curl -X PUT "https://app.pipeline.help/api/agent-workflows/00000000-0000-4000-8000-000000000000" \-H "Authorization: Bearer $PIPELINE_API_KEY"
Response
The operation is available, but its typed response schema has not been published yet.
HTTP errors
- 401
- Missing or invalid API key.
- 403
- Authenticated but not permitted for the workspace or resource.
- 404
- The requested resource was not found.