# Cockroach Labs — API Agent Score

> Score: 68/100 (Grade: C) | Domain: cockroachlabs.com | Rubric: 1.0.0 | Checked: July 24, 2026

Cockroach Labs scored 68/100 (C), classified "partially-ready".

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

## Summary

- Overall: 68/100 (C)
- Classification: partially-ready

## Category Scores

- API Design: 88/100 (A)
- Developer Experience: 75/100 (B)
- Agent Discovery: 83/100 (A)
- Agent Understanding: 80/100 (A)
- Agent Usability: 40/100 (F)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="2024-09-16") and date-based-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Schema coverage & depth — Medium parameter complexity (avg 1.9 params/op; nested/body schemas present). Investigated: spec 83%, sdk 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [fail] Example coverage — 3% example coverage. Investigated: spec 0%, docs 0%, sdk 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://www.cockroachlabs.com/pricing/; no free-tier language detected in docs/pricing. Investigated: docs 100%.
- [pass] Description completeness — 69% description completeness (target 90%+). Investigated: spec 100%.
- [pass] Changelog published — Newest official SDK activity 11 day(s) ago. Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Quickstart present — Quickstart page reachable (1 variants scanned starting at https://www.cockroachlabs.com/pricing/) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [fail] Code samples in docs — No detectable code samples across 15 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 1 pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — CLI documented with install instructions (download, download). Investigated: cli 100%, sdk 88%, docs 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt found at any candidate location (https://www.cockroachlabs.com/docs/stable/llms.txt, https://www.cockroachlabs.com/llms.txt, https://www.cockroachlabs.com/docs/llms.txt). Investigated: docs 33%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 5 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%.
- [pass] Operation purpose clarity — 100% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 1 of 1 pages have substantive content differences between markdown and HTML (avg 22% missing). Investigated: docs 90%.
- [warn] Docs structured data — JSON-LD on 1/11 assessed pages, but coverage is sparse or dateModified is missing. Investigated: docs 50%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (docs, sdk) is 0% (threshold 35% for full credit).

### Agent Usability

- [fail] Idempotency documented — 1% of mutating operations document idempotency. Investigated: spec 0%, docs 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Sandbox separation — No sandbox/test server declared across 1 server entries; no test-key prefixes documented. Investigated: spec 0%, docs 0%.
- [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

CockroachLabs' API program shows genuine strength in documentation discoverability and structured data quality, giving partners a solid starting point. However, the program has critical gaps in operational reliability and safe integration — partners and their AI agents cannot confidently run real workflows without idempotency guidance, rate-limit signaling, or a proper sandbox environment. Equally urgent, the absence of runnable collections with test scripts means agents have no executable truth to build against. Closing these gaps should be the immediate priority, followed by enriching examples and agent-oriented context so partners can move from discovery to production without friction.