Create workflow

veryfront__create_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 new workflow.
idstringYesStable workflow identifier used in MCP and project source. Minimum length: 1. Maximum length: 128.
descriptionstring or nullNoOptional short description of what the workflow does.
versionstring or nullNoOptional workflow version string.
schedulablebooleanNoWhether the workflow can be triggered by schedulers.
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__create_workflow",
    "arguments": {
      "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 new workflow."
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[a-z0-9][a-z0-9-]*$",
      "description": "Stable workflow identifier used in MCP and project source."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional short description of what the workflow does."
    },
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional workflow version string."
    },
    "schedulable": {
      "type": "boolean",
      "description": "Whether the workflow can be triggered by schedulers."
    },
    "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": [
    "id"
  ],
  "additionalProperties": false,
  "description": "Arguments for creating 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#"
}