Quick overview
This workflow exposes a webhook that accepts an exported n8n workflow JSON, runs static validation and risk checks, then uses Groq (Llama 3.3 70B) via an AI agent to return a structured JSON review with metrics, risks, and best-practice recommendations.
How it works
- Receives a POST request via a webhook containing a
workflow object with exported n8n workflow JSON.
- Validates the payload structure and analyzes the workflow to generate metrics and findings such as orphan nodes, dead ends, missing error handling, placeholder credentials, deprecated nodes, and documentation gaps.
- Routes valid analyses to a Groq-powered AI agent that explains each finding (why it matters, risk, business impact, and best-practice fix) and formats the response as structured JSON.
- Routes invalid or malformed inputs to a formatter that returns a consistent
{ success: false, error } JSON response.
- Responds to the original webhook request with the final JSON analysis.
Setup
- Add a Groq API credential in the Groq Chat Model node. You can generate a free API key at console.groq.com if you don't have one yet.
- Activate the workflow and copy the webhook URL from the Webhook trigger. This is the endpoint you'll send workflow JSON to for analysis.
- Configure your caller to POST { "workflow": { ... } } to the webhook URL, with the exported workflow JSON nested under the workflow key in the request body.