{"skill":{"slug":"n8n-hub","displayName":"n8n Hub","summary":"Centralized n8n hub for designing reliable flows (idempotency, retries, HITL) and operating them via the public REST API. Use for planning, JSON output, and lifecycle actions like list/publish/debug.","description":"---\nname: n8n-hub\ndescription: Centralized n8n hub for designing reliable flows (idempotency, retries, HITL) and operating them via the public REST API. Use for planning, JSON output, and lifecycle actions like list/publish/debug.\n---\n\n# n8n Hub\n\nThis skill merges two tracks:\n1) **Design**: plan dependable workflows and optionally emit `workflow.json`.\n2) **Operate**: handle workflows/executions via the public REST API.\n\n## Availability\n- Public API access is disabled on free trial plans.\n- An upgraded plan is required to use the API.\n\n## Configuration\n\nSuggested environment variables (or store in `.n8n-api-config`):\n\n```bash\nexport N8N_API_BASE_URL=\"https://your-instance.app.n8n.cloud/api/v1\"  # or http://localhost:5678/api/v1\nexport N8N_API_KEY=\"your-api-key-here\"\n```\n\nCreate an API key at: n8n Settings → n8n API → Create an API key.\n\n## Use this skill when\n- You want a workflow built for idempotency, retries, logging, and review queues.\n- You need importable `workflow.json` plus a runbook template.\n- You want to list, publish, deactivate, or debug workflows/executions via API.\n\n## Do not use when\n- You need pure code automation without n8n.\n- You want to bypass security controls or conceal audit trails.\n\n## Inputs\n**Required**\n- Trigger type + schedule/timezone\n- Success criteria and destinations (email/Drive/DB)\n\n**Optional**\n- Existing workflow JSON\n- Sample payloads/records\n- Dedup keys\n\n## Outputs\n- Default: design spec (nodes, data contracts, failure modes)\n- On request: `workflow.json` + `workflow-lab.md` (from `assets/workflow-lab.md`)\n\n## Auth header\nAll requests must include:\n\n```\nX-N8N-API-KEY: $N8N_API_KEY\n```\n\n## Quick actions (API)\n\n### Workflows: list\n```bash\ncurl -s -H \"X-N8N-API-KEY: $N8N_API_KEY\" \"$N8N_API_BASE_URL/workflows\" \\\n  | jq '.data[] | {id, name, active}'\n```\n\n### Workflows: details\n```bash\ncurl -s -H \"X-N8N-API-KEY: $N8N_API_KEY\" \"$N8N_API_BASE_URL/workflows/{id}\"\n```\n\n### Workflows: activate or deactivate\n```bash\n# Activate (publish)\ncurl -s -X POST -H \"X-N8N-API-KEY: $N8N_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"versionId\":\"\",\"name\":\"\",\"description\":\"\"}' \\\n  \"$N8N_API_BASE_URL/workflows/{id}/activate\"\n\n# Deactivate\ncurl -s -X POST -H \"X-N8N-API-KEY: $N8N_API_KEY\" \\\n  \"$N8N_API_BASE_URL/workflows/{id}/deactivate\"\n```\n\n### Webhook trigger\n```bash\ncurl -s -X POST \"$N8N_API_BASE_URL/../webhook/{webhook-path}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"key\":\"value\"}'\n```\n\n### Executions: list\n```bash\ncurl -s -H \"X-N8N-API-KEY: $N8N_API_KEY\" \\\n  \"$N8N_API_BASE_URL/executions?limit=10\" \\\n  | jq '.data[] | {id, workflowId, status, startedAt}'\n```\n\n### Executions: retry\n```bash\ncurl -s -X POST -H \"X-N8N-API-KEY: $N8N_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"loadWorkflow\":true}' \\\n  \"$N8N_API_BASE_URL/executions/{id}/retry\"\n```\n\n## Design workflow checklist\n1. Confirm trigger type and schedule/timezone.\n2. Define inputs, outputs, and validation rules.\n3. Choose dedup keys to keep runs idempotent.\n4. Add observability (run_id, logs, status row).\n5. Add retry policy and error branches.\n6. Send failures to a review queue.\n7. Add guardrails to prevent silent failure.\n\n## Endpoint index\nSee `assets/endpoints-api.md` for the complete endpoint list.\n\n## Notes and tips\n- The API playground is available only on self-hosted n8n and uses real data.\n- The n8n API node can call the public API from within workflows.\n- Webhook URLs do not require the API key header.\n- Execution data can be pruned by retention settings.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":2983,"installsAllTime":5,"installsCurrent":5,"stars":3,"versions":1},"createdAt":1769964396321,"updatedAt":1778485946485},"latestVersion":{"version":"1.0.0","createdAt":1769964396321,"changelog":"Initial release: centralized n8n hub for reliable workflow design and API-based operations.\n\n- Plan and generate idempotent n8n flows with retries, logging, and human-in-the-loop (HITL) patterns.\n- Interact with workflows and executions via documented public REST API endpoints.\n- Provides design specs, importable `workflow.json`, and `workflow-lab.md` runbook on request.\n- Includes examples for workflow management (list, activate/deactivate, webhook, retry executions).\n- Documents environment variable setup, required/optional inputs, outputs, and API authentication.\n- Details eligibility (API disabled on free trials) and security limitations.","license":null},"metadata":null,"owner":{"handle":"codedao12","userId":"s17ax1y7n44r8sjagk48sw25bx84nzpq","displayName":"codedao12","image":"https://avatars.githubusercontent.com/u/249323427?v=4"},"moderation":null}