# n8n — API Agent Score

> Score: 76/100 (Grade: B) | Domain: n8n.io | Rubric: 1.0.0 | Checked: July 24, 2026

n8n scored 76/100 (B), classified "partially-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/n8n)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 76/100 (B)
- Classification: partially-ready

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 67/100 (C)
- Agent Discovery: 91/100 (A+)
- Agent Understanding: 60/100 (C)
- Agent Usability: 67/100 (C)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="1.1.1") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 58/58 (100%) public params are fully typed (no any/**kwargs). Analyzer confirms all methods have a derivable input schema. Investigated: sdk 100%, spec 67%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [pass] Example coverage — Code samples present on 1/20 pages across 2 language(s); broader multi-language coverage missing. Investigated: docs 100%, sdk 50%, spec 0%.

### Developer Experience

- [pass] Code samples in docs — Code samples present on 1/20 pages across 2 language(s); broader multi-language coverage missing. Investigated: docs 100%.
- [pass] Description completeness — 86% description completeness (target 90%+). Investigated: spec 100%, sdk 0%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.n8n.io/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (2 variants scanned starting at https://docs.n8n.io/) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [fail] Self-service developer portal — No signup page detected across conventional paths (/signup, /sign-up, /register, /get-started, /console/signup, /dashboard/signup, /try, /try-free, /free, /free-trial, /start, /start-free). Investigated: docs 0%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 50 sampled pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (n8n-io/n8n-docs, 9493 snippets). Investigated: docs 100%, cli 100%, sdk 75%.
- [warn] llms.txt present, valid & comprehensive — llms.txt is 276,937 characters (exceeds 100,000 threshold; will be truncated by most agents). Investigated: docs 75%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap present (9 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 9 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%, sdk 0%.
- [warn] Agent-navigable, token-efficient docs — 1 of 32 pages have substantive content differences between markdown and HTML (avg 7% missing). Investigated: docs 78%.
- [fail] Operation purpose clarity — 22% of operations are agent-inferable. Investigated: spec 0%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 2 assessed pages (2 JS-rendered). Investigated: docs 0%.
- [skip] Description consistency across surfaces — Only 0 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [pass] Pagination documented & consistent — Pagination params detected on 19 list endpoint(s). Investigated: spec 100%, docs 100%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

n8n's agent discoverability is a clear strength — your docs are findable and crawlable by both humans and machines. The critical gaps sit in agent understanding and usability: operation-level descriptions are too thin for AI agents to reason about safely, there is no machine-readable context file to orient agents on how to use your API, and partners have no runnable collection with validated examples to build against. Fixing these three areas will meaningfully shorten the time partners need to ship a working integration and reduce the risk of agents hallucinating incorrect usage patterns.