# Yoofooz API Readiness Report

## API
**Name:** ElevenLabs API
**Docs URL:** https://elevenlabs.io/docs
**Domain:** elevenlabs.io
**Generated At:** 2026-10-05T21:39:38.490835+00:00

## Certification
**Agent Readiness Score:** 75/100
**Certification Level:** Yoofooz Ready

## Agent Commerce Readiness
**Agent Commerce Score:** 30/100
**Agent Commerce Level:** Agent Commerce Emerging

This score is separate from the core Agent Readiness Score and evaluates MCP support, scoped agent identity, machine-native payments, consumption pricing, budget controls, rate controls, deterministic errors, auditability, least-privilege security, and agent observability.

## Category Scores
- Documentation Clarity: 10
- Machine Readable Spec: 5
- Authentication Clarity: 10
- Error Handling: 10
- Rate Limit Clarity: 5
- Agent Safe Workflow Support: 5
- Sandbox Availability: 5
- Webhook Event Support: 10
- Commercial Trust: 5
- Developer Experience: 10

## Strengths
- Documentation clarity
- Authentication model clarity
- Error handling and status codes
- Webhook / event support
- Developer experience (SDKs, quickstart, CLI)

## Risks
- Machine-readable specification (OpenAPI/Swagger) signal is partial; clearer documentation recommended.
- Rate-limit / quota behavior signal is partial; clearer documentation recommended.
- Agent-safe workflow primitives (idempotency, retries) signal is partial; clearer documentation recommended.
- Sandbox / test-mode availability signal is partial; clearer documentation recommended.
- Commercial trust (status, SLA, compliance) signal is partial; clearer documentation recommended.

## Recommended Next Steps
- Strengthen: Add or expose an OpenAPI/Swagger specification or Postman collection.
- Strengthen: Document rate limits, quota behavior, 429 responses, and Retry-After guidance.
- Strengthen: Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.
- Strengthen: Provide a sandbox / test mode with test API keys for safe agent testing.
- Strengthen: Publish status page, SLA, and security/compliance posture (SOC 2, GDPR, PCI as applicable).

## Evidence Signals

### Documentation clarity
- **Source:** https://elevenlabs.io/docs/api-reference/mcp/get.md
- **Matched:** parameters, request, response, examples, docs, reference
- **Evidence:** "...eu) - `https://api.in.residency.elevenlabs.io` (production india) - `https://api.sg.residency.elevenlabs.io` (production singapore) request path parameters - `mcp_server_id` (string, required) — id of the mcp server. response 200 successful response - `id` (string, required) - `config`..."

- **Source:** https://elevenlabs.io/docs/api-reference/mcp/list.md
- **Matched:** parameters, request, response, examples, docs, reference
- **Evidence:** "...for per-tool approval. - `tool_name` (string, required) — the name of the mcp tool - `tool_hash` (string, required) — sha256 hash of the tool's parameters and description - `approval_policy` (enum, optional, default: requires_approval) — the approval policy for this tool - allowed values:..."

### Machine-readable specification (OpenAPI/Swagger)
- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** endpoints, schema
- **Evidence:** "...can include total credits and usd price. individual test runs can include credits and a charging breakdown. flows - **template api**: added endpoints to list and retrieve published flows templates, start template runs and retrieve run results. runs can target a published version and send their..."

- **Source:** https://elevenlabs.io/docs/api-reference/mcp/get.md
- **Matched:** schema
- **Evidence:** "...enable this to use extracted arrays directly as list dynamic variables. mcptoolconfigoverrideoutputinputoverrides - `source`: `constant` (constantschemaoverride) - `constant_value` (workflowtoollocatorschemaoverridesdiscriminatormappingconstantconstantvalue, required, nullable) — the constant value..."

### Authentication model clarity
- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** oauth, authentication, api key, keys
- **Evidence:** "...cli - [v1.4.0](https://github.com/elevenlabs/cli/releases/tag/v1.4.0) - fixed requests with an explicit api key so they no longer also send stored oauth credentials, which caused authentication failures. added descriptions for the feedback command group and instructions for reporting missing..."

- **Source:** https://elevenlabs.io/docs/api-reference/mcp/get.md
- **Matched:** authentication, authorization
- **Evidence:** "...variable resolved per call. - `auth_connection` (mcpserverconfigoutputauthconnection, optional, nullable) — optional auth connection to use for authentication with this mcp server - `description` (string, optional, default: ) - `pre_tool_speech` (enum, optional, default: auto) — controls whether the agent..."

### Error handling and status codes
- **Source:** https://elevenlabs.io/docs/api-reference/webhooks/update.md
- **Matched:** 429, 500, retry, errors
- **Evidence:** "...(used for display purposes only). - `retry_enabled` (boolean, optional, nullable) — whether to enable automatic retries for transient failures (5xx, 429, timeout) - `request_headers` (map from string to string, optional, nullable) — a list of request headers to include with the webhook delivery..."

- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** 409, retry
- **Evidence:** "...[design a voice](/docs/api-reference/text-to-voice/design) and [remix a voice](/docs/api-reference/text-to-voice/remix) - added a `409` response when a generation for the preview is already in progress. retry the request after receiving this response. workspaces - [create service..."

### Rate-limit / quota behavior
- **Source:** https://elevenlabs.io/docs/api-reference/webhooks/update.md
- **Matched:** 429
- **Evidence:** "...(used for display purposes only). - `retry_enabled` (boolean, optional, nullable) — whether to enable automatic retries for transient failures (5xx, 429, timeout) - `request_headers` (map from string to string, optional, nullable) — a list of request headers to include with the webhook delivery..."

- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** limits
- **Evidence:** "...runs. regenerated clients and types for gpt image 2.5, slack agent alerting, parallel tool calls, `gpt-6-astra`, service account api key concurrency limits, music zero retention, conversation filters and mcp tool approval statuses. python sdk -..."

### Agent-safe workflow primitives (idempotency, retries)
- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** simulate, metadata, request id
- **Evidence:** "...` - individual test runs add optional nullable `credits_used` (integer) and `charging` (`conversationchargingcommonmodel`). - [simulate conversation](/docs/api-reference/agents/simulate-conversation) and [simulate conversation..."

- **Source:** https://elevenlabs.io/docs/api-reference/mcp/get.md
- **Matched:** metadata, validation
- **Evidence:** "...required) — id of the mcp server. response 200 successful response - `id` (string, required) - `config` (mcpserverconfig-output, required) - `metadata` (mcpservermetadataresponsemodel, required) — the metadata of the mcp server - `access_info` (resourceaccessinfo, optional, nullable) — the access..."

### Sandbox / test-mode availability
- **Source:** https://elevenlabs.io/docs/api-reference/mcp/get.md
- **Matched:** mock
- **Evidence:** "...from string to mcptoolconfigoverrideoutputinputoverrides, optional, nullable) — mapping of json path to input override configuration - `response_mocks` (list of toolresponsemockconfig-output, optional, nullable) — mock responses with optional parameter conditions. evaluated top-to-bottom; first..."

- **Source:** https://elevenlabs.io/docs/api-reference/mcp/list.md
- **Matched:** mock
- **Evidence:** "...from string to mcptoolconfigoverrideoutputinputoverrides, optional, nullable) — mapping of json path to input override configuration - `response_mocks` (list of toolresponsemockconfig-output, optional, nullable) — mock responses with optional parameter conditions. evaluated top-to-bottom; first..."

### Webhook / event support
- **Source:** https://elevenlabs.io/docs/api-reference/webhooks/update.md
- **Matched:** webhooks, webhook, events, callback, subscriptions
- **Evidence:** "...in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # update workspace webhook patch https://api.elevenlabs.io/v1/workspace/webhooks/ content-type: application/json update the specified workspace webhook reference: https://elevenlabs.io/docs/api-reference/webhooks/update servers -..."

- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** webhook, events
- **Evidence:** "...flows templates, start template runs and retrieve run results. runs can target a published version and send their terminal result to a configured webhook. text to dialogue - **generation continuity**: text to dialogue requests can use preceding or following text and request ids to maintain continuity..."

### Commercial trust (status, SLA, compliance)
- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** support, changelog
- **Evidence:** "...through the text to dialogue websocket for agents and interactive applications. compare the two model variants, voice cloning behavior, settings and supported languages. generate high-quality dialogue with eleven v4. stream eleven v4 turbo dialogue over a websocket connection. speech to text -..."

- **Source:** https://elevenlabs.io/docs/api-reference/mcp/get.md
- **Matched:** support
- **Evidence:** "...(boolean, optional, default: false) — whether to disable http compression for this mcp server. enable this if the server does not support compressed responses. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — deprecated: use `pre_tool_speech` instead. if..."

### Developer experience (SDKs, quickstart, CLI)
- **Source:** https://elevenlabs.io/docs/changelog.md
- **Matched:** sdk, cli, guides
- **Evidence:** "...mode**: text to dialogue requests can use the instant voice clone version of a professional voice clone to reduce latency or improve expressiveness. sdk releases javascript sdk - [v2.70.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.70.0) - added batch and realtime speech to text..."

- **Source:** https://elevenlabs.io/docs/api-reference/mcp/get.md
- **Matched:** sdk, cli
- **Evidence:** "...false, 'force_pre_tool_speech': false, 'disable_interruptions': false }, 'metadata': , 'access_info': , 'dependent_agents': [ ] } ``` **sdk code** ```typescript import from '@elevenlabs/elevenlabs-js'; async function main() main(); ``` ```python from elevenlabs import elevenlabs client =..."

## AI Analyst Summary
AI analysis unavailable: NVIDIA analysis failed: http 410

## Yoofooz Summary
This API has been evaluated for autonomous AI-agent usability. The score reflects documentation quality, machine-readable specification signals, authentication clarity, error handling, workflow safety, commercial trust, and developer experience.