# Twelvelabs — API Agent Score

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

Twelvelabs scored 73/100 (B), classified "partially-ready".

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

## Summary

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

## Category Scores

- API Design: 72/100 (B)
- Developer Experience: 53/100 (D)
- Agent Discovery: 91/100 (A+)
- Agent Understanding: 61/100 (C)
- Agent Usability: 90/100 (A+)

## Check Results

### API Design

- [warn] Schema coverage & depth — 7 of 160 public signatures use loose types (anyTypeRatio=0.044). Investigated: sdk 91%.
- [pass] Example coverage — README is present and includes a runnable quickstart. Investigated: sdk 100%, docs 0%.
- [fail] Security & governance hygiene — No security.txt at /.well-known/security.txt or /security.txt. Investigated: wellknown 0%.
- [skip] Machine-readable, versioned contract — No surface produced evidence for this capability in this run.
- [skip] Auth declared & discoverable — No surface produced evidence for this capability in this run.

### Developer Experience

- [pass] Changelog published — Newest official SDK activity 1 day(s) ago. Investigated: sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (1 variants scanned starting at https://docs.twelvelabs.io/docs/get-started/quickstart) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [warn] Description completeness — 16/52 operations lack a description. Investigated: sdk 69%.
- [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 1 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/twelvelabs_io, 2746 snippets). Investigated: docs 100%, mcp 100%, sdk 58%, cli 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 0/1 sitemap doc pages (0%); 1 missing. Investigated: docs 75%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap lastmod coverage 71% or newest entry older than 90 days. Investigated: wellknown 75%.

### Agent Understanding

- [warn] Agent-navigable, token-efficient docs — 3 of 4 endpoints have aggressive caching or missing cache headers. Investigated: docs 90%.
- [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 1 sampled pages — likely a CSR-only docs site. Investigated: docs 0%.
- [skip] Machine-readable errors (RFC 9457) — No surface produced evidence for this capability in this run.
- [skip] Operation purpose clarity — No surface produced evidence for this capability in this run.
- [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%.
- [pass] Pagination documented & consistent — 5/5 list method(s) return an auto-paginating iterable. Investigated: sdk 100%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.
- [skip] Rate-limit signaling — No surface produced evidence for this capability in this run.

## Executive Summary

Twelvelabs has strong API discoverability and crawlability in place, but two areas are putting partner and agent adoption at risk: developer onboarding is friction-heavy (no self-service portal, sparse code samples), and agents lack the structured context they need to understand and act on the API confidently (no AGENTS.md, no structured docs metadata, incomplete security hygiene). Prioritize building a self-service, agent-ready documentation experience first, then close the runnable-truth and security gaps so partners and their agents can move from discovery to working integration without manual intervention.