# Reducto — API Agent Score

> Score: 84/100 (Grade: A) | Domain: reducto.ai | Rubric: 1.0.0 | Checked: July 24, 2026

Reducto scored 84/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 94/100 (A+)
- Developer Experience: 70/100 (B)
- Agent Discovery: 98/100 (A+)
- Agent Understanding: 70/100 (B)
- Agent Usability: 88/100 (A)

## Check Results

### API Design

- [pass] Schema coverage & depth — 64/64 (100%) public params are fully typed (no any/**kwargs). Analyzer reports not 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.reducto.ai/studio-account. Investigated: spec 100%, docs 100%.
- [warn] Machine-readable, versioned contract — info.version="v1.12.1-344-g94292fd8ca10" 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 100%.
- [pass] Example coverage — Code samples present on 1/20 pages across 2 language(s); broader multi-language coverage missing. Investigated: docs 100%, sdk 100%, spec 0%.

### Developer Experience

- [pass] Quickstart present — Quickstart at https://docs.reducto.ai/quickstart with a runnable first-call sample. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples present on 1/20 pages across 2 language(s); broader multi-language coverage missing. Investigated: docs 100%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.reducto.ai/onprem/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Description completeness — 21/41 operations lack a description. Investigated: sdk 49%, spec 0%.
- [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] Docs reachable, not hard auth-gated — All 1 pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/reducto_ai, 2670 snippets). Investigated: docs 100%, cli 100%, sdk 92%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt contains parseable links but doesn't fully follow the proposed structure: https://docs.reducto.ai/llms.txt: No blockquote summary found. Investigated: docs 92%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — error codes documented in the docs site at https://docs.reducto.ai/reference/error-codes. Investigated: docs 100%, sdk 100%, spec 50%.
- [pass] Agent-navigable, token-efficient docs — All 1 pages contain server-rendered content. Investigated: docs 100%.
- [pass] Docs structured data — JSON-LD Article markup on 19/19 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [fail] Operation purpose clarity — 53% 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%.
- [skip] Description consistency across surfaces — Only 1 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### 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.reducto.ai/reference/checking-api-health. Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Pagination documented & consistent — 4/5 list method(s) return an auto-paginating iterable. Investigated: sdk 80%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Reducto's API program shows strong foundations in machine-readable contract quality and documentation discovery, meaning agents can already find and parse the API surface. The critical gaps are in operation-level clarity and agent-specific guidance: without clear per-operation semantics and an AGENTS.md file, AI agents building against the API must guess at intent, leading to brittle or incorrect integrations. The immediate priority is enriching the API's semantic layer and providing a dedicated agent-instruction context, followed by adding a runnable, test-backed collection so partners can validate real workflows end-to-end before going live.