{"openapi":"3.1.0","info":{"title":"ElevenLabs Voices (BYOK) API","version":"0.1.0","description":"ElevenLabs Voices (BYOK) lets an AI assistant read your own ElevenLabs Voices data through the ElevenLabs Voices API with a key you supply (API key). Read-only: 10 tools (list_shared_voices, get_voice, get_voice_settings, get_default_voice_settings, list_voice_collections, list_voice_accents, get_pronunciation_dictionary, list_music_finetunes, get_audio_effects_catalog, list_speech_engines). The...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-elevenlabs-voices.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-elevenlabs-voices/docs"},"termsOfService":"https://connectorbay.com/byok-elevenlabs-voices/terms"},"servers":[{"url":"https://byok-elevenlabs-voices.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-elevenlabs-voices/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_shared_voices":{"post":{"operationId":"list_shared_voices","summary":"Search the public voice library by language, accent, gender, age, use case or text, with usage counts and clone counts. ","description":"Search the public voice library by language, accent, gender, age, use case or text, with usage counts and clone counts. Page size up to 100, pages start at 0. Use for \"Find popular British English female voices in the ElevenLabs voice library\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":30,"description":"Voices per page (1 to 100, default 30).","title":"Page Size"},"page":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page number, starting at 0.","title":"Page"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Search text for voice names and descriptions.","title":"Search"},"language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Language code to filter by, for example en.","title":"Language"},"accent":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Accent to filter by, for example british (see list_voice_accents).","title":"Accent"},"gender":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Gender to filter by, for example female or male.","title":"Gender"},"age":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Age group to filter by, for example young or middle_aged.","title":"Age"},"category":{"anyOf":[{"enum":["professional","famous","high_quality"],"type":"string"},{"type":"null"}],"default":null,"description":"Voice category to filter by.","title":"Category"},"featured":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to show only featured voices.","title":"Featured"},"sort":{"anyOf":[{"enum":["created_date","usage_character_count_1y","trending","cloned_by_count"],"type":"string"},{"type":"null"}],"default":"created_date","description":"Order by created_date, usage_character_count_1y, trending or cloned_by_count.","title":"Sort"}},"title":"list_shared_voicesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_voice":{"post":{"operationId":"get_voice","summary":"Get one voice's metadata: name, category, labels, description, preview URL, creation time and whether you own it. Use fo","description":"Get one voice's metadata: name, category, labels, description, preview URL, creation time and whether you own it. Use for \"What are the details of this ElevenLabs voice\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"voice_id":{"description":"Voice id, for example from list_shared_voices or an ElevenLabs voice list.","maxLength":200,"title":"Voice Id","type":"string"}},"required":["voice_id"],"title":"get_voiceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_voice_settings":{"post":{"operationId":"get_voice_settings","summary":"Get the stored text-to-speech settings of one voice: stability, similarity boost, style, speed and speaker boost. Use fo","description":"Get the stored text-to-speech settings of one voice: stability, similarity boost, style, speed and speaker boost. Use for \"What stability and speed settings does this ElevenLabs voice use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"voice_id":{"description":"Voice id, for example from list_shared_voices or an ElevenLabs voice list.","maxLength":200,"title":"Voice Id","type":"string"}},"required":["voice_id"],"title":"get_voice_settingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_default_voice_settings":{"post":{"operationId":"get_default_voice_settings","summary":"Get the default text-to-speech voice settings used when a voice has none of its own. Use for \"What are the default Eleve","description":"Get the default text-to-speech voice settings used when a voice has none of its own. Use for \"What are the default ElevenLabs voice settings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_default_voice_settingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_voice_collections":{"post":{"operationId":"list_voice_collections","summary":"List the voice collections you can access with id, title, icon and your permission, sorted by title. Use for \"Which voic","description":"List the voice collections you can access with id, title, icon and your permission, sorted by title. Use for \"Which voice collections do I have in ElevenLabs\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_voice_collectionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_voice_accents":{"post":{"operationId":"list_voice_accents","summary":"List the accents available in the shared voice library with language code and display name, optionally for one language ","description":"List the accents available in the shared voice library with language code and display name, optionally for one language or model. Use for \"Which accents can I filter ElevenLabs shared voices by for English\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only accents of this language code, for example en.","title":"Language"},"model_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only accents available for this model id.","title":"Model Id"}},"title":"list_voice_accentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_pronunciation_dictionary":{"post":{"operationId":"get_pronunciation_dictionary","summary":"Get one pronunciation dictionary with its latest version id, rule count and the rules (text to replace and alias or phon","description":"Get one pronunciation dictionary with its latest version id, rule count and the rules (text to replace and alias or phoneme). Use for \"What rules does this ElevenLabs pronunciation dictionary contain\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pronunciation_dictionary_id":{"description":"Pronunciation dictionary id from the dictionary list.","maxLength":200,"title":"Pronunciation Dictionary Id","type":"string"}},"required":["pronunciation_dictionary_id"],"title":"get_pronunciation_dictionaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_music_finetunes":{"post":{"operationId":"list_music_finetunes","summary":"List music finetunes you can use (yours, workspace-shared and curated) with base model, visibility, creator, training st","description":"List music finetunes you can use (yours, workspace-shared and curated) with base model, visibility, creator, training status and progress. Use for \"Which music finetunes are available to me in ElevenLabs\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's next_cursor to get the following page.","title":"Cursor"},"page_size":{"anyOf":[{"maximum":150,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Finetunes per page (1 to 150, default 50).","title":"Page Size"},"visibility":{"anyOf":[{"enum":["private","workspace","public"],"type":"string"},{"type":"null"}],"default":null,"description":"Only finetunes with this visibility.","title":"Visibility"},"created_by":{"anyOf":[{"enum":["self","workspace","elevenlabs"],"type":"string"},{"type":"null"}],"default":null,"description":"Only finetunes by this creator group.","title":"Created By"},"sort":{"anyOf":[{"enum":["created_at","name"],"type":"string"},{"type":"null"}],"default":"created_at","description":"Order by created_at or name.","title":"Sort"},"sort_direction":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"asc or desc.","title":"Sort Direction"}},"title":"list_music_finetunesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_audio_effects_catalog":{"post":{"operationId":"get_audio_effects_catalog","summary":"List the filter presets, reverb environments and background noises that audio_effects settings can reference, with ids a","description":"List the filter presets, reverb environments and background noises that audio_effects settings can reference, with ids and descriptions. Use for \"Which audio effect presets can I use in ElevenLabs text to speech\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_audio_effects_catalogArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_speech_engines":{"post":{"operationId":"list_speech_engines","summary":"List Speech Engine resources with name, assigned voice id, tags and creation time. Page size up to 100. Use for \"Which E","description":"List Speech Engine resources with name, assigned voice id, tags and creation time. Page size up to 100. Use for \"Which ElevenLabs speech engines have I created\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's next_cursor to get the following page.","title":"Cursor"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":30,"description":"Engines per page (1 to 100, default 30).","title":"Page Size"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only engines whose name matches this text.","title":"Search"}},"title":"list_speech_enginesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}