# Cohere — API Agent Score

> Score: 85/100 (Grade: A) | Domain: cohere.com | Rubric: 1.0.0 | Checked: July 24, 2026

Cohere scored 85/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 94/100 (A+)
- Developer Experience: 66/100 (C)
- Agent Discovery: 95/100 (A+)
- Agent Understanding: 72/100 (B)
- Agent Usability: 95/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 — 1363/1377 (99%) public params are fully typed (no any/**kwargs). Analyzer reports not all methods have a derivable input schema. Investigated: sdk 99%, spec 80%.
- [warn] Machine-readable, versioned contract — info.version="1.0.0" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — 8% example coverage. Investigated: spec 100%, sdk 100%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://dashboard.cohere.com/welcome/register; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Description completeness — 85% description completeness (target 90%+). Investigated: spec 100%, sdk 76%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.cohere.com/v2/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [fail] Code samples in docs — No detectable code samples across 2 sampled docs pages. 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 (websites/cohere, 4449 snippets). Investigated: docs 100%, sdk 58%, cli 0%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 189/278 sitemap doc pages (68%); 89 missing. Investigated: docs 81%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — No 4xx/5xx response codes (or default error response) documented anywhere in the spec. Investigated: docs 100%, sdk 100%, spec 50%.
- [warn] Operation purpose clarity — 75% of operations are agent-inferable (target 90%+). Investigated: spec 90%.
- [warn] Agent-navigable, token-efficient docs — 12 of 50 pages have substantive content differences between markdown and HTML (avg 12% missing). Investigated: docs 60%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (spec, sdk) is 8% (threshold 35% for full credit).
- [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 sampled pages — likely a CSR-only docs site. Investigated: docs 0%.

### 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://docs.cohere.com/docs/rate-limits. Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Runnable collection with test scripts — No test scripts found in the workspace's collections. Investigated: platform 50%.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

Cohere's API program shows strong fundamentals in API design, agent usability, and discovery — partners and agents can find and run against a well-structured contract. The two areas that need priority attention are agent understanding and developer onboarding: there are no structured cues or instruction files to help AI agents parse and act on Cohere's docs autonomously, and partners lack the quickstart resources and embedded code samples needed to reach a first successful call quickly. Closing these gaps will meaningfully accelerate partner integration and make Cohere's APIs first-class citizens in AI-assisted development workflows.