# Storyblok — API Agent Score

> Score: 88/100 (Grade: A) | Domain: storyblok.com | Rubric: 1.0.0 | Checked: August 26, 2026

Storyblok scored 88/100 (A), classified "ai-ready".

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

## Summary

- Overall: 88/100 (A)
- Classification: ai-ready

## Category Scores

- API Design: 94/100 (A+)
- Developer Experience: 84/100 (A)
- Agent Discovery: 79/100 (B)
- Agent Understanding: 83/100 (A)
- Agent Usability: 100/100 (A+)

## Check Results

### API Design

- [warn] Schema coverage & depth — 0/17 (0%) enum-like params are realized as constrained types (not bare strings). Investigated: sdk 86%.
- [pass] Security & governance hygiene — Code is formatter-clean with zero linter errors and zero style warnings. Investigated: sdk 100%, wellknown 0%.
- [pass] Example coverage — Code samples appear on 1 of 20 sampled docs pages across 1 language(s), but broader multi-language coverage is missing. Investigated: docs 100%, sdk 100%.
- [skip] Machine-readable, versioned contract — No surface produced evidence for this capability in this run.
- [skip] Auth declared & discoverable — No surface produced evidence for this capability in this run.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://app.storyblok.com/ (client-rendered, so its contents couldn't be classified); free tier or sandbox is documented in pricing/docs. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples appear on 1 of 20 sampled docs pages across 1 language(s), but broader multi-language coverage is missing. Investigated: docs 100%.
- [pass] Changelog published — Newest official SDK activity 0 day(s) ago. Investigated: sdk 100%.
- [warn] Quickstart present — Quickstart page is reachable at https://www.storyblok.com/docs (1 variants scanned) but has no runnable code sample in its HTML or .md variant, so there's nothing to copy and run. Investigated: docs 50%.
- [warn] Description completeness — 8/19 operations lack a description. Investigated: sdk 58%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (websites/storyblok, 5795 snippets). Investigated: docs 100%, sdk 58%, cli 50%.
- [warn] Docs reachable, not hard auth-gated — Server ignores Accept: text/markdown header (0/50 sampled pages return markdown). Investigated: docs 75%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt directive found in HTML of any of 50 sampled pages. Investigated: docs 50%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap has 9 entries but no lastmod values, so crawlers can't tell what changed recently. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — Single base error "Error" with 2 subclasses. Investigated: sdk 100%.
- [warn] Agent-navigable, token-efficient docs — 16 of 50 pages have minor content differences between markdown and HTML. Investigated: docs 89%.
- [warn] Operation purpose clarity — Read/write classification is mostly ambiguous: only 9/19 operations classified. Investigated: sdk 74%.
- [warn] Agent instructions file (AGENTS.md) — No agents.md or skill.md context file found (nice-to-have for agent operation). Investigated: sdk 50%, wellknown 0%.
- [warn] Docs structured data — JSON-LD markup on only 1 of 17 assessed pages, and coverage is sparse or dateModified is missing. Investigated: docs 50%.
- [skip] Description consistency across surfaces — Only 1 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%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%.
- [pass] Runnable collection with test scripts — README is present and includes a runnable quickstart. Investigated: sdk 100%, platform 0%.
- [skip] Rate-limit signaling — No surface produced evidence for this capability in this run.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

Storyblok's API program is performing well overall, with strong API design and developer experience fundamentals already in place. The two areas most worth sharpening are agent discoverability and agent understanding — specifically ensuring that AI agents and partners can find, parse, and act on your APIs without friction or a sales conversation. Prioritizing a machine-readable documentation front door and runnable onboarding artifacts will close the remaining gaps and put Storyblok ahead of the curve for the AI-agent integration wave.