API Reference

31 AI endpoints + 1 infrastructure endpoint

Auth

All AI endpoints accept either a server-side x-api-key header (workspace key) or a session cookie issued by the magic-link flow. Public health endpoint requires no auth.

curl -X POST https://vector.8n.ai/api/title-cards \
  -H "Content-Type: application/json" \
  -H "x-api-key: ws_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"brief":"Last To Leave 100-Hour Cube Wins $250,000","count":5}'

Webhooks

Register a webhook URL per workspace to receive POST callbacks when long-running AI jobs complete or comments are added. Events: ai.completed, doc.exported, comment.added.

AI Endpoints (31)

POST /api/aiNatural-language command interpretation → editor ops
POST /api/traceRaster image trace (Claude Vision)
POST /api/recolorRecolor selected shapes via mood prompt
POST /api/patternGenerate seamless SVG pattern from prompt
POST /api/mockupCompose artboard onto product mockup (t-shirt, mug, etc.)
POST /api/cloud-savePersist .v8n to cloud drive
POST /api/pdf-importImport .pdf/.ai/.eps via Claude Vision (use /api/native-pdf for stream parser)
POST /api/icon-setGenerate icon set grid from prompt + count
POST /api/logoGenerate brand logo (mark + wordmark + palette)
POST /api/paletteAI Color Palette generator from prompt
POST /api/retypeIdentify font in image (Claude Vision)
POST /api/shape-fillAI Generative shape fill
POST /api/color-matchExtract dominant colors from reference image
POST /api/brand-kitExtract full brand kit (palette + fonts + voice + style)
POST /api/accessibilityWCAG 2.2 AA audit (contrast + fonts + colorblindness + alt text)
POST /api/code-exportConvert SVG → React/Vue/Svelte/Lit component (TS/JS)
POST /api/layout-tidyAI alignment + grouping suggestions
POST /api/critiqueCreative-director scoring with action items
POST /api/brand-complianceAudit design vs saved Brand Kit
POST /api/auto-nameSemantic kebab-case shape naming
POST /api/smart-selectNatural-language → matching shape IDs
POST /api/ab-variantsN variants with hypothesis + predicted lift
POST /api/animation-storyboardMotion timeline from current artboard
POST /api/title-cardsMrBeast-style YouTube title cards
POST /api/lower-thirdBroadcast lower-thirds with animation timing
POST /api/stage-packCoordinated graphics kit for competitions
POST /api/merch-patternTileable patterns for merch (Feastables-style)
POST /api/bulk-variants10-100 A/B variants with axis control + predicted CTR delta
POST /api/sponsor-integrationFull sponsor-read kit (5 assets + FTC + code)
POST /api/video-storyboardScript → shot-by-shot timeline
POST /api/end-screenYouTube end-screen with safe zones

Infrastructure

GET /api/healthService health (all services + latency + uptime + version)

Plugin SDK

Plugins run in an iframe sandbox and communicate with the host via postMessage. Each plugin declares its manifest (id, name, permissions, host URL). The host exposes a stable API for reading selection, mutating shapes, calling AI routes, and showing UI panels.

{
  "id": "com.example.grid-snap",
  "name": "Grid Snap Pro",
  "version": "1.0.0",
  "host": "https://plugins.example.com/grid-snap",
  "permissions": ["read:selection","write:shapes","ui:panel"]
}

Quotas

Free: 100 AI calls/day · Team: 5,000/day · Enterprise: custom. Quota counter resets at 00:00 UTC. x-quota-remaining header returned on every response.