workflow_definition_publish

Tool

workflow_definition_publish

Publish the draft as the next immutable version and make it live.

Publish the draft as the next immutable version and make it live. Refused with 422 and the issues while validation reports any error. First publish enables the workflow; one an operator disabled stays disabled.

Behavior

HTTP: POST /workflow/definition/publish

Arguments

Name	Type	Required	Description
note	string	•	Why this version exists; shown in the version list.
workflow_id	string	•	No description in the catalog.

Response

Field	Type	Always	Description
grants	object	•	What Governance holds for this workflow after the request; null when the request did not reach it. A publish never approves anything — a human sponsors it in Workspace.
status	string	•
version	number	•
workflow_id	string	•
dependencies	array	•

Try it

Publish the draft as the next immutable version and make it live.

When to use

Example

Ask your agent something like this:

Publish the draft as the next immutable version and make it live.

The agent will invoke workflow_definition_publish with these arguments:

{
  "note": "<note>",
  "workflow_id": "<workflow_id>"
}