# Confluent — API Agent Score

> Score: 82/100 (Grade: A) | Domain: confluent.io | Rubric: 1.0.0 | Checked: July 24, 2026

Confluent scored 82/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 89/100 (A)
- Developer Experience: 75/100 (B)
- Agent Discovery: 78/100 (B)
- Agent Understanding: 73/100 (B)
- Agent Usability: 92/100 (A+)

## Check Results

### API Design

- [pass] Schema coverage & depth — 9/9 (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 documented in the docs site at https://docs.confluent.io/cloud/current/security/authenticate/workload-identities/service-accounts/api-keys/overview.html. Investigated: docs 100%, spec 75%, wellknown 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [warn] Machine-readable, versioned contract — No info.version and no versioning scheme detected. Investigated: spec 50%, docs 0%.
- [pass] Example coverage — 69% example coverage (target 80%+). Investigated: spec 100%, sdk 100%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://www.confluent.io/get-started/; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Description completeness — 96% of operations + parameters have substantive descriptions. Investigated: spec 100%, sdk 100%.
- [pass] Changelog published — Structured changelog feed declared: https://www.iana.org/assignments/link-relations/link-relations.xml. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (12 variants scanned starting at https://docs.confluent.io/index.html) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [fail] Code samples in docs — No detectable code samples across 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (websites/confluent_io, 97663 snippets). Investigated: docs 100%, sdk 100%, cli 100%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 58/5770 sitemap doc pages (1%); 5712 missing; 18 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 63%, sdk 0%.
- [warn] Docs reachable, not hard auth-gated — 50 of 50 sampled pages return 200 for non-existent URLs (soft 404). Investigated: docs 50%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 11 distinct 4xx/5xx response codes documented. Investigated: docs 100%, sdk 100%, spec 50%.
- [pass] Operation purpose clarity — 99% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 4 of 41 pages have substantive content differences between markdown and HTML (avg 5% missing). Investigated: docs 65%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 3 surfaces (spec, docs, sdk) is 1% (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 1 assessed pages (1 JS-rendered). 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 — 4 distinct rate-limit response headers documented. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 16 list endpoint(s). Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — Test credentials signaled (test-key prefixes) but no sandbox server declared in spec. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Confluent's API program shows real strengths in contract quality and documentation discoverability, but two areas create meaningful friction for partners and their AI agents today. First, agent-facing context is incomplete — no AGENTS.md, no structured data on docs pages, and no machine-readable discovery signals mean AI coding agents must guess at how to work with the API rather than act on explicit instructions. Second, there are no runnable collections with test scripts, so partners lack a verified, executable starting point and agents lack the concrete request/response shapes needed to integrate correctly. Prioritize closing the agent-understanding gaps first, then add runnable truth to compress the time from first look to first working integration.