# Stytch — API Agent Score

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

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

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

## Summary

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

## Category Scores

- API Design: 79/100 (B)
- Developer Experience: 67/100 (C)
- Agent Discovery: 83/100 (A)
- Agent Understanding: 55/100 (D)
- Agent Usability: 90/100 (A+)

## Check Results

### API Design

- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Schema coverage & depth — 0/41 (0%) enum-like params are realized as constrained types (not bare strings). Investigated: sdk 86%, spec 83%.
- [warn] Machine-readable, versioned contract — info.version="2.1.1" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [pass] Example coverage — 58% example coverage (target 80%+). Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Security & governance hygiene — 22 credential-shaped strings detected in spec: private-key-pem (×22). Investigated: spec 0%, wellknown 0%.

### Developer Experience

- [pass] Code samples in docs — Code samples present on 3/20 pages across 2 language(s); broader multi-language coverage missing. Investigated: docs 100%.
- [pass] Description completeness — 83% description completeness (target 90%+). Investigated: spec 100%, sdk 100%.
- [pass] Changelog published — changelog documented in the docs site at https://stytch.com/docs/api-reference/b2b/frontend-sdks/react/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (12 variants scanned starting at https://stytch.com/docs/login?redirect=%2Fquickstart) 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] Registry & SDK presence — Indexed on Context7 (websites/stytch, 6865 snippets). Investigated: docs 100%, sdk 100%, cli 50%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 251/1888 sitemap doc pages (13%); 1637 missing; 8 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 81%, sdk 0%.
- [warn] Docs reachable, not hard auth-gated — 50 of 50 sampled pages return 200 for non-existent URLs (soft 404). Investigated: docs 63%.
- [warn] Crawlable / AEO — Sitemap present (2 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

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

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://stytch.com/blog/stytch-fraud-and-risk-prevention-major-enhancements/. Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — sandbox documented in the docs site at https://stytch.com/blog/guide-to-authentication-for-the-openai-apps-sdk/. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

Stytch's API program shows real strengths in agent discoverability and API design, where partners and their agents can already find and parse the surface with confidence. The critical gap is agent understanding: operation descriptions, structured documentation data, and agent-facing instruction files are all missing or inconsistent, meaning AI agents building on Stytch's APIs must guess at intent rather than act with certainty — slowing integrations and increasing support load. Closing the agent understanding gaps and adding runnable, test-backed collections should be the immediate priority to unlock both partner self-service and reliable AI-assisted development.