• SUCCESS
  • ERROR
  • HUMAN
  • PENDING

How to validate workflow definitions with your AI

Connect Conductor to your agent to catch logic errors before they hit your production environment. Your AI acts as a pre-deployment gatekeeper for your JSON definitions.

Ask AI about this page

Short answer

How can I check my Conductor workflow JSON for errors using AI?

Your agent uses the validate_workflow_definition tool to scan your JSON for syntax errors or broken logic. It identifies issues immediately so you can fix them before calling create_workflow_definition. You get a clear breakdown of what's broken and how to fix it.

Where every issue lands.

Validation outcomes

The AI categorizes the results of your workflow checks into these specific states.

SUCCESS

Valid JSON logic

The agent confirms the definition is sound. You're ready to deploy the workflow to the Conductor service.

ERROR

Syntax or logic flaws

The agent flags specific lines or missing keys. You receive a list of errors to resolve before trying again.

HUMAN

Manual review needed

The agent finds ambiguous logic that isn't technically broken but looks suspicious. You decide if the business logic actually makes sense.

PENDING

Deployment ready

Once the check passes, the agent holds the definition. You can then trigger the creation of the workflow.

The workflow

What your AI does when a definition arrives.

The agent handles the heavy lifting of structural verification so you don't have to hunt through nested JSON objects.

  1. Scan for errors

    The agent parses your raw JSON to find missing required fields or incorrect data types.

    validate_workflow_definition

  2. Identify broken paths

    It checks that all task references and transitions point to existing components within the definition.

    validate_workflow_definition

  3. Propose fixes

    After finding a mistake, the agent suggests the corrected JSON structure to you.

    validate_workflow_definition

  4. Deploy definition

    Once you approve the corrected version, the agent pushes the valid definition to the server.

    create_workflow_definition

Try it

Copy these to start.

Use these prompts to kick off the validation process.

Starting points

Swap out the bracketed text with your actual JSON code or file path.

Conductor (Netflix OSS) Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_TUjFjxN9H3g5Ba44H63GIIO4Av31lZmg9U3GcY2P/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Conductor (Netflix OSS) capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "conductor-netflix-oss-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_TUjFjxN9H3g5Ba44H63GIIO4Av31lZmg9U3GcY2P/mcp"
    }
  }
}
Copy into chat04

  • Can you validate this Conductor JSON for me: [paste JSON here]?

  • Check this workflow definition for any broken task transitions: [paste JSON here]

  • I need to deploy a new workflow. Validate this definition first: [paste JSON here]

  • Why is this Conductor definition failing validation? [paste JSON here]

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Conductor once, then ask.

Just link your Conductor credentials to Vinkius. Your login stays encrypted and you can immediately start chatting with your agent about your workflows.

Connect Conductor to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix my JSON automatically?

    No. The agent identifies the errors and suggests corrections, but you must review and approve the changes before they are applied.

  • 02

    Does the AI deploy the workflow by itself?

    No. The agent only uses the creation tool when you explicitly tell it to deploy a validated definition.

  • 03

    Can it check for business logic errors?

    It can check for structural and schema errors. It cannot know if your specific business process is logically sound for your company's needs.

  • 04

    Will it delete existing workflows?

    No. The available tools only allow for validation and creation. There is no tool to delete or modify existing definitions.

  • 05

    What happens if the JSON is totally malformed?

    The validation tool will return a failure, and the agent will tell you exactly where the syntax error is located.

  • More questions about Conductor? The Connector page answers them. See everything the Conductor Connector can do

Connect Conductor (Netflix OSS) to Claude, Cursor, ChatGPT & more