n8n-api-setup

n8n API Setup for Cursor AI Agents

Version: 1.0
Date: January 30, 2026
Owner: AI Team

---

1. Purpose

This guide enables Cursor AI agents to inspect and interact with n8n workflows. n8n is our workflow automation platform (being phased out in favor of Mastra agents).

Note: We are migrating away from n8n. This documentation is primarily for inspection and migration purposes.

---

2. Credentials Location

1Password:

• Vault: Brainforge AI Team
• Item: N8N API UTTAM (or search for “n8n”)
• Fields:
  • username - API username
  • password - API password

Environment Variables:

N8N_URL=https://brainforge.app.n8n.cloud
N8N_USERNAME=your_username
N8N_PASSWORD=your_password

---

3. API Authentication

n8n uses HTTP Basic Authentication.

cURL Authentication:

curl -X GET "https://brainforge.app.n8n.cloud/api/v1/workflows" \
  -u "${N8N_USERNAME}:${N8N_PASSWORD}" \
  -H "Content-Type: application/json"

---

4. Common Operations

4.1 List Workflows

curl -s -X GET "https://brainforge.app.n8n.cloud/api/v1/workflows" \
  -u "${N8N_USERNAME}:${N8N_PASSWORD}" \
  -H "Content-Type: application/json"

4.2 Get Workflow Details

# By workflow ID
curl -s -X GET "https://brainforge.app.n8n.cloud/api/v1/workflows/R8DDLBawugPZ0GZu" \
  -u "${N8N_USERNAME}:${N8N_PASSWORD}" \
  -H "Content-Type: application/json"

4.3 Get Workflow Executions

curl -s -X GET "https://brainforge.app.n8n.cloud/api/v1/executions?workflowId=R8DDLBawugPZ0GZu" \
  -u "${N8N_USERNAME}:${N8N_PASSWORD}" \
  -H "Content-Type: application/json"

---

5. Workflow Structure

n8n workflows consist of:

• Nodes - Individual processing steps
• Connections - Data flow between nodes
• Triggers - Webhook, schedule, or manual start

Example Node Types:

• n8n-nodes-base.webhook - HTTP webhook trigger
• n8n-nodes-base.httpRequest - External API calls
• n8n-nodes-langchain.openAi - LLM integration
• n8n-nodes-base.code - Custom JavaScript

---

6. Inspecting Workflows for Migration

When migrating to Mastra agents, extract:

1. Trigger type - What starts the workflow?
2. Input data - What data does it receive?
3. Processing steps - What transformations occur?
4. External calls - What APIs are called?
5. Output format - What data is returned?

Example inspection:

# Get workflow and parse nodes
curl -s -X GET "https://brainforge.app.n8n.cloud/api/v1/workflows/WORKFLOW_ID" \
  -u "${N8N_USERNAME}:${N8N_PASSWORD}" | \
  python3 -c "
import json, sys
data = json.load(sys.stdin)
for node in data.get('nodes', []):
    print(f\"- {node['type']}: {node['name']}\")
"

---

7. UI Access

• Dashboard: https://brainforge.app.n8n.cloud
• Workflow Editor: https://brainforge.app.n8n.cloud/workflow/WORKFLOW_ID

---

8. API Reference

• API Docs: https://docs.n8n.io/api/
• Node Types: https://docs.n8n.io/integrations/builtin/

---

9. Migration Status

Workflow	Status	Replacement
Zoom Meeting Title	Migrated	meetingTitleAgent (Mastra)
Zoom Meeting Summary	Migrated	meetingSummaryAgent (Mastra)
Zoom Transcript Pipeline	Migrated	zoomExport.ts

---

10. Version History

• v1.0 (January 30, 2026) — Initial documentation for migration purposes