# Netlify — API Agent Score

> Score: 74/100 (Grade: B) | Domain: netlify.com | Rubric: 1.0.0 | Checked: July 24, 2026

Netlify scored 74/100 (B), classified "partially-ready".

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

## Summary

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

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 99/100 (A+)
- Agent Discovery: 93/100 (A+)
- Agent Understanding: 60/100 (C)
- Agent Usability: 45/100 (F)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="2.57.0") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 81/81 (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: docs 100%, spec 50%, wellknown 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — Code samples in 3 language(s) across docs (top: typescript, shell, javascript); 2/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%, sdk 50%, spec 0%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://app.netlify.com/signup; free tier / sandbox documented. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://docs.netlify.com/start/quickstarts/deploy-from-repository/ with a runnable first-call sample. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples in 3 language(s) across docs (top: typescript, shell, javascript); 2/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [warn] Description completeness — 55/59 operations carry a description. Investigated: sdk 93%, spec 0%.
- [pass] Changelog published — changelog documented in the docs site at https://www.netlify.com/changelog/. Investigated: spec 100%, docs 100%, sdk 100%.

### 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 (websites/netlify, 5871 snippets). Investigated: docs 100%, cli 100%, sdk 75%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 105/415 sitemap doc pages (25%); 310 missing. Investigated: docs 75%, sdk 0%.
- [pass] Crawlable / AEO — No robots.txt on the docs host — AI crawlers unrestricted. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 7 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%.
- [warn] Agent-navigable, token-efficient docs — 5 of 50 pages have substantive content differences between markdown and HTML (avg 7% missing). Investigated: docs 89%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 3 surfaces (spec, docs, sdk) is 3% (threshold 35% for full credit).
- [fail] Operation purpose clarity — 0% 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 3 assessed pages (3 JS-rendered). Investigated: docs 0%.

### Agent Usability

- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%, sdk 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Pagination documented & consistent — 35 list endpoint(s) exist but no pagination params found. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Netlify's API program shows strong discoverability and developer experience fundamentals, but partners and their AI agents face two critical blockers: operations lack the semantic clarity and reliability signals agents need to build safe, automated workflows, and there is no runnable, verifiable artifact for agents or partners to execute against. Fixing operational reliability documentation and adding executable, test-backed collections should be the immediate priority, followed by closing the agent context and structured-data gaps that prevent agents from understanding and acting on the API surface without human intervention.