Workflows
MCP tools for the Workflows module. See the Workflows module docs for permissions and data model.
list-workflows
List workflows
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | — |
limit | number | no | Results per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED. |
cursor | string | no | The previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR. |
create-workflow
Create a workflow
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | — |
name | string | yes | — |
description | string | null | no | — |
states | array<object> | yes | — |
transitions | array<object> | yes | — |
payload_schema | object | null | no | — |
version_label | string | no | Optional tag for the version this create archives, e.g. initial. |
get-workflow
Get a workflow
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | — |
update-workflow
Update a workflow
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | — |
name | string | no | — |
description | string | null | no | — |
states | array<object> | no | — |
transitions | array<object> | no | — |
payload_schema | object | null | no | — |
version_label | string | no | Optional tag for the version this write creates, e.g. rewired. Ignored when the write changes no definition field, since no version is archived. |
expected_version | any | no | Refuses the write unless the resource is at this version. |
delete-workflow
Delete a workflow
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | — |
list-workflow-versions
List a workflow's versions
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | — |
limit | number | no | Results per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED. |
cursor | string | no | The previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR. |
get-workflow-version
Fetch an archived workflow version
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | — |
version | number | yes | The archived version number |
restore-workflow-version
Restore an archived workflow state machine
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | — |
version | number | yes | The archived version number |
label | string | no | Optional tag for the new version the restore archives. Defaults to restored from vN. |
create-workflow-migration
Migrate a workflow's open tasks to one of its versions
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | The workflow whose tasks migrate. |
to_version | number | yes | The workflow version to move the open tasks onto. |
state_map | object | no | Current state name to a state the target version declares, applied to every task as migrate-task applies it to one. |
wait | boolean | no | When omitted or false (default), the run is answered queued and settles in the background; poll get-workflow-migration. Pass true to answer once every task has settled. |
get-workflow-migration
Get a workflow migration
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
workflow_id | string | yes | The workflow whose tasks migrate. |
migration_id | string | yes | The workflow migration to read. |