# Baseten — API Agent Score

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

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

[View full report](https://www.postman.com/ai/ai-ready-apis/company/baseten)
[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: 85/100 (A)
- Agent Discovery: 91/100 (A+)
- Agent Understanding: 67/100 (C)
- Agent Usability: 92/100 (A+)

## Check Results

### API Design

- [pass] Schema coverage & depth — 618/618 (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 required (global or on every operation). Investigated: spec 100%, docs 100%.
- [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 — README is present and includes a runnable quickstart. Investigated: sdk 100%, spec 0%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://app.baseten.co/signup; no free-tier language detected in docs/pricing. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://docs.baseten.co/quickstart has a runnable sample in the .md variant (https://docs.baseten.co/quickstart.md). Investigated: docs 100%.
- [pass] Description completeness — 95% of operations + parameters have substantive descriptions. Investigated: spec 100%, sdk 100%.
- [pass] Changelog published — Newest official SDK activity 0 day(s) ago. Investigated: sdk 100%, spec 0%, docs 0%.
- [fail] Code samples in docs — No detectable code samples across 18 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 — Indexed on Context7 (websites/baseten_co, 9545 snippets). Investigated: docs 100%, cli 100%, sdk 58%.
- [warn] llms.txt present, valid & comprehensive — No /llms-full.txt found at the candidate origins. Investigated: docs 67%, 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.baseten.co/deployment/autoscaling/request-lifecycle. Investigated: spec 100%, docs 100%, sdk 0%.
- [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 18/18 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (docs, sdk) is 4% (threshold 35% for full credit).
- [fail] Operation purpose clarity — 0% 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%.

### 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.baseten.co/api-reference/cancel-a-queued-async-request. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 10 list endpoint(s). Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Baseten's API program shows strong performance in design, discovery, and overall usability — partners can find and invoke the APIs reliably. The two areas that need immediate attention are agent understanding and runnable context: AI agents and integration tools lack the operation-level clarity and executable examples they need to build correctly without guessing, which slows partner adoption and increases support load. Prioritize enriching operation semantics and adding an agent instructions file first, then layer in runnable, test-backed collections so agents and partners can validate end-to-end workflows with confidence.