Update a workflow

PATCH 
/api/v1/workflows/:workflow_id

Updates a workflow definition. Structural changes (states/transitions) are re-validated. Existing tasks in a removed state stay put but can only leave via transitions valid in the new definition.

Request

Responses

200

Workflow updated

400

Bad request (invalid definition)

401

Unauthorized

403

Forbidden

404

Workflow not found

409

The resource has moved past the version this write read (VERSION_CONFLICT): a stated expected_version or If-Match no longer matches, or a concurrent write took the version first. meta.current_version names the version in force. Nothing is written.

413

REQUEST_REJECTED — the request body is over the size the body parser accepts

429

QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens

Response Headers

Retry-After

Seconds until the quota window admits a request again

500

Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded