# Together — API Agent Score

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

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

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

## Summary

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

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 59/100 (D)
- Agent Discovery: 93/100 (A+)
- Agent Understanding: 78/100 (B)
- Agent Usability: 92/100 (A+)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="2.0.0") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 3089/3093 (100%) public params are fully typed (no any/**kwargs). Analyzer reports not all methods have a derivable input schema. Investigated: sdk 100%, spec 83%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [pass] Example coverage — README is present and includes a runnable quickstart. Investigated: sdk 100%, spec 0%, docs 0%.

### Developer Experience

- [pass] Quickstart present — Quickstart at https://docs.together.ai/docs/quickstart has a runnable sample in the .md variant (https://docs.together.ai/docs/quickstart.md). Investigated: docs 100%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.together.ai/docs/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Description completeness — 315/811 operations lack a description. Investigated: sdk 61%, 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%.
- [fail] Code samples in docs — No detectable code samples across 20 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/together_ai, 3547 snippets). Investigated: docs 100%, sdk 58%, cli 0%.
- [warn] llms.txt present, valid & comprehensive — No /llms-full.txt found at the candidate origins. Investigated: docs 75%, sdk 0%.
- [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] Agent-navigable, token-efficient docs — All 1 pages contain server-rendered content. Investigated: docs 100%.
- [warn] Operation purpose clarity — 73% of operations are agent-inferable (target 90%+). Investigated: spec 50%.
- [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 (spec, docs) is 14% (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

- [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.together.ai/docs/serverless/rate-limits. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 39 list endpoint(s). Investigated: spec 100%, docs 100%, sdk 0%.
- [pass] Sandbox separation — sandbox documented in the docs site at https://docs.together.ai/docs/together-code-sandbox. 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

Together's API design and agent discovery are strong, giving partners a solid foundation to build on. The most urgent gaps are in developer onboarding and agent-readiness: partners lack a self-service portal with real code samples, and there is no agent instructions file or runnable collection to let AI agents and human developers hit the ground running. Closing these two gaps will compress partner evaluation time, reduce support burden, and ensure AI agents can reliably integrate against Together's APIs without guesswork.
