validate_workflow
Validate a workflow's readiness by checking for structural and catalog issues. Use workflowId for catalog-aware validation or document for stateless structural checks. Returns launchable status and issues list.
Instructions
Check a workflow for problems. Returns launchable, catalogChecked, and an issues list (each with code, message, severity, stepIds, edgeIds).
Pass EXACTLY ONE of workflowId or document — they answer different questions:
workflowId → validates the STORED workflow against this tenant's catalog. This is the real 'can this run?': it confirms the agents, tools and flows the steps reference actually exist. Answers catalogChecked: true.
document → validates the document you pass, STATELESSLY. No database, so read-only service tokens can call it, but with no catalog the cross-entity checks cannot run:
launchablehere means 'structurally sound', NOT 'this will run'. Answers catalogChecked: false. Use it for a draft you have not saved, or for fast feedback while editing.
A green verdict is what a reader remembers, so check catalogChecked before telling anyone a workflow is ready. Call this after apply_workflow_mutations and before request_publish_workflow.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| document | No | Validate this document statelessly (as returned by read_workflow). Omit if you are passing a workflowId. | |
| workflowId | No | Validate this STORED workflow against the tenant catalog. Omit if you are passing a document. |