# Runway — API Agent Score

> Score: 75/100 (Grade: B) | Domain: runwayml.com | Rubric: 1.0.0 | Checked: July 24, 2026

Runway scored 75/100 (B), classified "partially-ready".

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

## Summary

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

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 59/100 (D)
- Agent Discovery: 83/100 (A)
- Agent Understanding: 61/100 (C)
- Agent Usability: 74/100 (B)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="2024-11-06") and header-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 — 1951/1953 (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] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — Code samples in 5 language(s) across docs (top: typescript, python, http); 2/2 pages have ≥ 2 languages on the same page. Investigated: docs 100%, sdk 100%, spec 0%.

### Developer Experience

- [pass] Code samples in docs — Code samples in 5 language(s) across docs (top: typescript, python, http); 2/2 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 81% description completeness (target 90%+). Investigated: spec 100%, sdk 82%.
- [pass] Changelog published — Newest official SDK activity 0 day(s) ago. Investigated: sdk 100%, spec 0%, docs 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] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (runwayml/sdk-python, 619 snippets). Investigated: docs 100%, cli 100%, sdk 92%, mcp 0%, wellknown 0%.
- [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.txt directive found in HTML of any of 50 sampled pages. Investigated: docs 69%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap present (1 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 4 distinct 4xx/5xx response codes documented. Investigated: docs 100%, sdk 100%, spec 50%.
- [warn] Agent-navigable, token-efficient docs — 4 of 49 pages have substantive content differences between markdown and HTML (avg 8% missing). Investigated: docs 80%.
- [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%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 2 assessed pages (2 JS-rendered). Investigated: docs 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] Pagination documented & consistent — Pagination params detected on 6 list endpoint(s). Investigated: spec 100%, docs 100%, sdk 91%.
- [pass] Sandbox separation — Sandbox server declared but no distinguishable test credentials in scheme descriptions. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Runwayml's API contract is a genuine strength — schema and types are solid, and discoverability is well covered. The critical gap is agent understanding: operations lack clear purpose descriptions, there is no AGENTS.md file to guide AI agents, and docs are not structured for machine parsing, meaning partners and their agents are forced to guess at intent rather than act with confidence. Closely behind, partners have no self-service portal or quickstart to get hands-on without a sales conversation, and there is no runnable collection to give agents the executable context they need for correct integrations. Prioritize making docs agent-readable and adding operational clarity first, then close the self-service onboarding gap.