# Weaviate — API Agent Score

> Score: 72/100 (Grade: B) | Domain: weaviate.io | Rubric: 1.0.0 | Checked: July 24, 2026

Weaviate scored 72/100 (B), classified "partially-ready".

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

## Summary

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

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 76/100 (B)
- Agent Discovery: 84/100 (A)
- Agent Understanding: 81/100 (A)
- Agent Usability: 42/100 (F)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="1.39.0-rc.0") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 11/11 (100%) public params are fully typed (no any/**kwargs). Analyzer confirms all methods have a derivable input schema. Investigated: sdk 100%, spec 50%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: docs 100%, spec 50%, wellknown 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [pass] Example coverage — Code samples in 6 language(s) across docs (top: python, typescript, shell); 5/10 pages have ≥ 2 languages on the same page. Investigated: docs 100%, sdk 100%, spec 0%.

### Developer Experience

- [pass] Quickstart present — Quickstart at https://docs.weaviate.io/weaviate/quickstart with a runnable first-call sample. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples in 6 language(s) across docs (top: python, typescript, shell); 5/10 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 90% description completeness (target 90%+). Investigated: spec 100%, sdk 21%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.weaviate.io/weaviate/release-notes. Investigated: spec 100%, docs 100%, sdk 100%.
- [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 (weaviate/docs, 6875 snippets). Investigated: docs 100%, sdk 100%, cli 100%.
- [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-full.txt found at the candidate origins. Investigated: docs 71%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap present (395 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

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

### Agent Usability

- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Idempotency documented — 9% of mutating operations document idempotency. Investigated: spec 0%, docs 0%, sdk 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Pagination documented & consistent — 7 list endpoint(s) exist but no pagination params found. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Weaviate's API program shows strong fundamentals in discovery and documentation parseability, but two areas need urgent attention before partners and AI agents can reliably build on it. Operational reliability is the most critical gap: partners and their agents have no documented guidance on idempotency, rate-limit signaling, or pagination, making production integrations fragile and error-prone. Closely behind, there is no runnable, executable collection for partners to validate real workflows against, and no machine-readable agent instruction file to orient AI agents to the API surface. Prioritizing operational contracts and runnable context will unblock partner integrations and dramatically reduce time spent on support escalations.