Update workflow

veryfront__update_workflow

Requires project.runs.write.

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
project_referencestringNoProject ID or slug that owns the workflow.
workflow_idstringYesExisting workflow identifier to update. Minimum length: 1.
descriptionstring or nullNoUpdated workflow description.
versionstring or nullNoUpdated workflow version string.
schedulablebooleanNoUpdated schedulable flag for the workflow definition.
source_target_kindstringNoProvide the source target kind.
target_branch_idstring or nullNoProvide the target branch id.

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__update_workflow",
    "arguments": {
      "workflow_id": "example"
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

FieldTypeRequiredDescription and constraints
idstringYesWorkflow identifier.
namestringYesHuman-readable workflow name.
descriptionstring or nullYesShort description of the workflow purpose.
targetstringYesExecution target that implements the workflow.
source_pathstringYesSource file path where the workflow definition lives.
sourcestringYesWorkflow source code or structured document content.
versionstring or nullYesVersion string for the workflow definition, when tracked.
schedulablebooleanYesWhether the workflow can be triggered by schedulers.
edit_modestringYesEditing mode supported for the workflow definition. Values: "structured", "source_only".
source_only_reasonsstring[]YesReasons why the workflow can only be edited as raw source, when applicable.

Full schemas

json
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug that owns the workflow."
    },
    "workflow_id": {
      "type": "string",
      "minLength": 1,
      "description": "Existing workflow identifier to update."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Updated workflow description."
    },
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "Updated workflow version string."
    },
    "schedulable": {
      "type": "boolean",
      "description": "Updated schedulable flag for the workflow definition."
    },
    "source_target_kind": {
      "type": "string",
      "description": "Provide the source target kind."
    },
    "target_branch_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "description": "Provide the target branch id."
        },
        {
          "type": "null",
          "description": "Provide the target branch id."
        }
      ],
      "description": "Provide the target branch id."
    }
  },
  "required": [
    "workflow_id"
  ],
  "additionalProperties": false,
  "description": "Arguments for updating a workflow definition.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Workflow identifier."
    },
    "name": {
      "type": "string",
      "description": "Human-readable workflow name."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Short description of the workflow purpose."
    },
    "target": {
      "type": "string",
      "description": "Execution target that implements the workflow."
    },
    "source_path": {
      "type": "string",
      "description": "Source file path where the workflow definition lives."
    },
    "source": {
      "type": "string",
      "description": "Workflow source code or structured document content."
    },
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "Version string for the workflow definition, when tracked."
    },
    "schedulable": {
      "type": "boolean",
      "description": "Whether the workflow can be triggered by schedulers."
    },
    "edit_mode": {
      "type": "string",
      "enum": [
        "structured",
        "source_only"
      ],
      "description": "Editing mode supported for the workflow definition."
    },
    "source_only_reasons": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Reasons why the workflow can only be edited as raw source, when applicable."
    }
  },
  "required": [
    "id",
    "name",
    "description",
    "target",
    "source_path",
    "source",
    "version",
    "schedulable",
    "edit_mode",
    "source_only_reasons"
  ],
  "additionalProperties": false,
  "description": "Workflow definition including editable source content.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}