true if the voice was successfully removed from favorites.
string
The voice ID that was removed.
Track voice usage
Records that a voice was used. This is a fire-and-forget operation; errors are logged server-side but do not cause the request to fail.
string
required
voices
string
required
track-usage
string
required
The voice ID to track usage for.
object
Show properties
string
The context in which the voice was used. Valid values:
Value
Description
preview
User previewed / listened to the voice sample
select
User selected the voice for an existing genie
agent_creation
Voice was chosen during new genie creation
string
The genie ID, if the usage is related to genie creation or configuration.
Authentication is optional. Anonymous usage is tracked when no token is provided.
Track-usage is a fire-and-forget operation. The endpoint always returns { success: true } even if the underlying database write fails. Errors are logged server-side but are never surfaced to the caller, so it is safe to call without awaiting or error-handling.
Always returns true, regardless of whether the tracking write succeeded internally.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Help Genie","description":"API documentation for the Help Genie voice AI platform","colors":{"primary":"#4E9CFF","light":"#7BB8FF","dark":"#2B7FE8"},"logo":{"light":"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/light.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f29d097a201254a8a750843d0d692c50","dark":"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/dark.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f00cbee677f1f3a3f46d463cb7cbad38","href":"https://helpgenie.ai"},"favicon":"https://mintcdn.com/helpgenie/17V8AwVjtycIuhCm/favicon.svg?fit=max\u0026auto=format\u0026n=17V8AwVjtycIuhCm\u0026q=85\u0026s=8a7865e1c10e3dacc378789f70f5ef6e","navbar":{"links":[{"href":"mailto:support@helpgenie.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://helpgenie.ai/dashboard"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/helpgenie"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Help Genie Voice","icon":"microphone","href":"https://helpgenie.ai"},{"anchor":"Help Genie Mail","icon":"envelope","href":"https://mail.helpgenie.ai"},{"anchor":"Help Genie Outbound","icon":"phone","href":"https://outbound.helpgenie.ai"},{"anchor":"Help Genie Sync","icon":"arrows-rotate","href":"https://sync.helpgenie.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"helpgenie","hasAudioNarration":false,"actualSubdomain":"helpgenie","customDomains":["docs.helpgenie.ai"],"gitSource":{"type":"github","owner":"help-genie-ai","repo":"help-genie-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af6f87607e6a796f0fd81d2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":54},{"language":"default","tag":"Voice","count":37},{"language":"default","tag":"Overview","count":20},{"language":"default","tag":"Expanded Platform","count":16},{"language":"default","tag":"Sync","count":13},{"language":"default","tag":"Mail","count":11},{"language":"default","tag":"Outbound","count":9},{"language":"default","tag":"Knowledge","count":6},{"language":"default","tag":"Working with mail","count":6},{"language":"default","tag":"Configuring a Genie","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/voices","slug":"/api-reference/voices","pageMetadata":{"title":"Voices","description":"Browse and search voices, manage favorites, and track voice usage","href":"/api-reference/voices"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Browse and search voices, manage favorites, and track voice usage\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseField,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`list-voices`,children:`List voices`}),`\n`,_jsx(_components.p,{children:`Retrieves available voices from the voice library with optional filtering and pagination.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`voices`})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`list`})})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`page_size`,type:`number`,id:`param-page-size`,children:_jsx(_components.p,{children:`Results per page. Maximum 100.`})}),_jsx(ParamField,{body:`page`,type:`number`,id:`param-page`,children:_jsx(_components.p,{children:`Page number (1-indexed).`})}),_jsx(ParamField,{body:`category`,type:`string`,id:`param-category`,children:_jsx(_components.p,{children:`Filter by voice category.`})}),_jsx(ParamField,{body:`gender`,type:`string`,id:`param-gender`,children:_jsxs(_components.p,{children:[`Filter by gender. One of `,_jsx(_components.code,{children:`\"male\"`}),` or `,_jsx(_components.code,{children:`\"female\"`}),`.`]})}),_jsx(ParamField,{body:`age`,type:`string`,id:`param-age`,children:_jsxs(_components.p,{children:[`Filter by age range. One of `,_jsx(_components.code,{children:`\"young\"`}),`, `,_jsx(_components.code,{children:`\"middle_aged\"`}),`, or `,_jsx(_components.code,{children:`\"old\"`}),`.`]})}),_jsx(ParamField,{body:`accent`,type:`string`,id:`param-accent`,children:_jsxs(_components.p,{children:[`Filter by accent (e.g. `,_jsx(_components.code,{children:`\"british\"`}),`, `,_jsx(_components.code,{children:`\"american\"`}),`, `,_jsx(_components.code,{children:`\"australian\"`}),`).`]})}),_jsx(ParamField,{body:`language`,type:`string`,id:`param-language`,children:_jsxs(_components.p,{children:[`Filter by language code (e.g. `,_jsx(_components.code,{children:`\"en\"`}),`, `,_jsx(_components.code,{children:`\"es\"`}),`, `,_jsx(_components.code,{children:`\"fr\"`}),`).`]})}),_jsx(ParamField,{body:`locale`,type:`string`,id:`param-locale`,children:_jsxs(_components.p,{children:[`Filter by locale (e.g. `,_jsx(_components.code,{children:`\"en-US\"`}),`, `,_jsx(_components.code,{children:`\"en-GB\"`}),`).`]})}),_jsx(ParamField,{body:`search`,type:`string`,id:`param-search`,children:_jsx(_components.p,{children:`Search by voice name.`})}),_jsx(ParamField,{body:`use_cases`,type:`string[]`,id:`param-use-cases`,children:_jsx(_components.p,{children:`Filter by intended use cases.`})}),_jsx(ParamField,{body:`descriptives`,type:`string[]`,id:`param-descriptives`,children:_jsx(_components.p,{children:`Filter by descriptive tags.`})}),_jsx(ParamField,{body:`featured`,type:`boolean`,id:`param-featured`,children:_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`true`}),`, return only featured voices.`]})}),_jsx(ParamField,{body:`sort`,type:`string`,id:`param-sort`,children:_jsx(_components.p,{children:`Sort order for results.`})})]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Request`,numberOfLines:`4`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"list\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1/voices`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"voices\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"list\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns voice library data forwarded directly from the upstream voice service.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`list-shared-voices`,children:`List shared voices`}),`\n`,_jsx(_components.p,{children:`Retrieves voices from the shared/community voice library with optional filtering and pagination.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-1`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`voices`})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-1`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`list-shared`})})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,id:`param-data-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`page_size`,type:`number`,id:`param-page-size-1`,children:_jsx(_components.p,{children:`Results per page. Maximum 100.`})}),_jsx(ParamField,{body:`page`,type:`number`,id:`param-page-1`,children:_jsx(_components.p,{children:`Page number (1-indexed).`})}),_jsx(ParamField,{body:`gender`,type:`string`,id:`param-gender-1`,children:_jsxs(_components.p,{children:[`Filter by gender. One of `,_jsx(_components.code,{children:`\"male\"`}),` or `,_jsx(_components.code,{children:`\"female\"`}),`.`]})}),_jsx(ParamField,{body:`age`,type:`string`,id:`param-age-1`,children:_jsxs(_components.p,{children:[`Filter by age range. One of `,_jsx(_components.code,{children:`\"young\"`}),`, `,_jsx(_components.code,{children:`\"middle_aged\"`}),`, or `,_jsx(_components.code,{children:`\"old\"`}),`.`]})}),_jsx(ParamField,{body:`accent`,type:`string`,id:`param-accent-1`,children:_jsxs(_components.p,{children:[`Filter by accent (e.g. `,_jsx(_components.code,{children:`\"british\"`}),`, `,_jsx(_components.code,{children:`\"american\"`}),`, `,_jsx(_components.code,{children:`\"australian\"`}),`).`]})}),_jsx(ParamField,{body:`language`,type:`string`,id:`param-language-1`,children:_jsx(_components.p,{children:`Filter by language code.`})}),_jsx(ParamField,{body:`search`,type:`string`,id:`param-search-1`,children:_jsx(_components.p,{children:`Search by voice name.`})}),_jsx(ParamField,{body:`use_cases`,type:`string[]`,id:`param-use-cases-1`,children:_jsx(_components.p,{children:`Filter by intended use cases.`})}),_jsx(ParamField,{body:`descriptives`,type:`string[]`,id:`param-descriptives-1`,children:_jsx(_components.p,{children:`Filter by descriptive tags.`})})]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Request`,numberOfLines:`4`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"list-shared\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1/voices`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"voices\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"list-shared\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-2`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns shared voice library data forwarded directly from the upstream voice service.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`search-voices`,children:`Search voices`}),`\n`,_jsx(_components.p,{children:`Searches the voice library by one or more search terms.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-2`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`voices`})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-2`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`search`})})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-2`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`terms`,type:`string[]`,required:true,id:`param-terms`,children:_jsx(_components.p,{children:`Array of search terms. At least one term is required.`})})})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Request`,numberOfLines:`7`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"search\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` terms:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Rachel\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"American\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"calm\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1/voices`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"voices\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"search\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"terms\": [\"Rachel\", \"American\", \"calm\"]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-3`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns matching voice data forwarded directly from the upstream voice service.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`list-favorite-voices`,children:`List favorite voices`}),`\n`,_jsx(_components.p,{children:`Retrieves all voices that the authenticated user has added to their favorites.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-3`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`voices`})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-3`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`favorites`})})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Request`,numberOfLines:`4`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"favorites\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1/voices`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"voices\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"favorites\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-4`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`favorites`,type:`VoiceFavorite[]`,id:`param-favorites`,children:[_jsx(_components.p,{children:`Array of favorited voice records.`}),_jsxs(Expandable,{title:`VoiceFavorite object`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Unique favorite record identifier.`})}),_jsx(ResponseField,{name:`user_id`,type:`string`,id:`param-user-id`,children:_jsx(_components.p,{children:`ID of the user who favorited the voice.`})}),_jsx(ResponseField,{name:`voice_id`,type:`string`,id:`param-voice-id`,children:_jsx(_components.p,{children:`The external voice identifier.`})}),_jsx(ResponseField,{name:`voice_data`,type:`object`,id:`param-voice-data`,children:_jsx(_components.p,{children:`Voice metadata stored at the time of favoriting.`})}),_jsx(ResponseField,{name:`favorited_at`,type:`string | null`,id:`param-favorited-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp of when the voice was favorited.`})})]})]}),`\n`,_jsx(ResponseField,{name:`count`,type:`number`,id:`param-count`,children:_jsx(_components.p,{children:`Total number of favorited voices.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`add-favorite-voice`,children:`Add favorite voice`}),`\n`,_jsx(_components.p,{children:`Adds a voice to the authenticated user’s favorites. If the voice is already favorited, returns the existing record without creating a duplicate.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-4`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`voices`})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-4`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`add-favorite`})})}),`\n`,_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-1`,children:_jsx(_components.p,{children:`The voice ID to add to favorites.`})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,id:`param-data-3`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`voice_data`,type:`object`,id:`param-voice-data-1`,children:_jsx(_components.p,{children:`Voice metadata to store with the favorite record (name, language, accent, etc.).`})})})}),`\n`,_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`Request`,numberOfLines:`12`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"add-favorite\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice-id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` voice_data:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Rachel\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` language:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"en\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` accent:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"American\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-status-201`,children:`Response (status 201)`}),`\n`,_jsx(ResponseField,{name:`favorite`,type:`VoiceFavorite`,id:`param-favorite`,children:_jsxs(_components.p,{children:[`The newly created favorite record. See the `,_jsx(_components.a,{href:`#list-favorite-voices`,children:`VoiceFavorite object`}),` for field details.`]})}),`\n`,_jsx(_components.p,{children:`If the voice is already favorited, the response returns:`}),`\n`,_jsx(ResponseField,{name:`already_favorited`,type:`boolean`,id:`param-already-favorited`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the voice was already in favorites.`]})}),`\n`,_jsx(ResponseField,{name:`voice_id`,type:`string`,id:`param-voice-id-1`,children:_jsx(_components.p,{children:`The voice ID that was already favorited.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`remove-favorite-voice`,children:`Remove favorite voice`}),`\n`,_jsx(_components.p,{children:`Removes a voice from the authenticated user’s favorites.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-5`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`voices`})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-5`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`remove-favorite`})})}),`\n`,_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-2`,children:_jsx(_components.p,{children:`The voice ID to remove from favorites.`})}),`\n`,_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`Request`,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"remove-favorite\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice-id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-5`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` if the voice was successfully removed from favorites.`]})}),`\n`,_jsx(ResponseField,{name:`voice_id`,type:`string`,id:`param-voice-id-2`,children:_jsx(_components.p,{children:`The voice ID that was removed.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`track-voice-usage`,children:`Track voice usage`}),`\n`,_jsx(_components.p,{children:`Records that a voice was used. This is a fire-and-forget operation; errors are logged server-side but do not cause the request to fail.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-6`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`voices`})})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-6`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`track-usage`})})}),`\n`,_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-3`,children:_jsx(_components.p,{children:`The voice ID to track usage for.`})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,id:`param-data-4`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`context`,type:`string`,id:`param-context`,children:[_jsx(_components.p,{children:`The context in which the voice was used. Valid values:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`preview`})}),_jsx(_components.td,{children:`User previewed / listened to the voice sample`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`select`})}),_jsx(_components.td,{children:`User selected the voice for an existing genie`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_creation`})}),_jsx(_components.td,{children:`Voice was chosen during new genie creation`})]})]})]})]}),_jsx(ParamField,{body:`agentId`,type:`string`,id:`param-agent-id`,children:_jsx(_components.p,{children:`The genie ID, if the usage is related to genie creation or configuration.`})})]})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Authentication is optional. Anonymous usage is tracked when no token is provided.`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Track-usage is a fire-and-forget operation. The endpoint always returns `,_jsx(_components.code,{children:`{ success: true }`}),` even if the underlying database write fails. Errors are logged server-side but are never surfaced to the caller, so it is safe to call without awaiting or error-handling.`]})}),`\n`,_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`Request`,numberOfLines:`9`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"track-usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice-id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` context:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_creation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent-uuid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-6`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-1`,children:_jsxs(_components.p,{children:[`Always returns `,_jsx(_components.code,{children:`true`}),`, regardless of whether the tracking write succeeded internally.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Voices","description":"Browse and search voices, manage favorites, and track voice usage","href":"/api-reference/voices"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"List voices","slug":"list-voices","depth":2,"children":[{"title":"Response","slug":"response","depth":3,"children":[]}]},{"title":"List shared voices","slug":"list-shared-voices","depth":2,"children":[{"title":"Response","slug":"response-2","depth":3,"children":[]}]},{"title":"Search voices","slug":"search-voices","depth":2,"children":[{"title":"Response","slug":"response-3","depth":3,"children":[]}]},{"title":"List favorite voices","slug":"list-favorite-voices","depth":2,"children":[{"title":"Response","slug":"response-4","depth":3,"children":[]}]},{"title":"Add favorite voice","slug":"add-favorite-voice","depth":2,"children":[{"title":"Response (status 201)","slug":"response-status-201","depth":3,"children":[]}]},{"title":"Remove favorite voice","slug":"remove-favorite-voice","depth":2,"children":[{"title":"Response","slug":"response-5","depth":3,"children":[]}]},{"title":"Track voice usage","slug":"track-voice-usage","depth":2,"children":[{"title":"Response","slug":"response-6","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"helpgenie","siteName":"Help Genie","title":"Voices - Help Genie","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-18T07:21:51.435Z","originalFileLocation":"api-reference/voices.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Browse and search voices, manage favorites, and track voice usage\">\u003cmeta data-mint-head name=\"application-name\" content=\"Help Genie\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Voices - Help Genie\">\u003cmeta data-mint-head property=\"og:description\" content=\"Browse and search voices, manage favorites, and track voice usage\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Help Genie\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.helpgenie.ai/api-reference/voices\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://helpgenie.mintlify.site/_mintlify/api/og/v2?division=Voice\u0026amp;title=Voices\u0026amp;description=Browse+and+search+voices%2C+manage+favorites%2C+and+track+voice+usage\u0026amp;theme=fc0888b7de96c166e1873963\u0026amp;signature=4e386917615bd10407889f0246559d64fb2dee7c83db86b68779ddb3b732b92a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Voices - Help Genie\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Browse and search voices, manage favorites, and track voice usage\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://helpgenie.mintlify.site/_mintlify/api/og/v2?division=Voice\u0026amp;title=Voices\u0026amp;description=Browse+and+search+voices%2C+manage+favorites%2C+and+track+voice+usage\u0026amp;theme=fc0888b7de96c166e1873963\u0026amp;signature=4e386917615bd10407889f0246559d64fb2dee7c83db86b68779ddb3b732b92a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Help Genie\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4E9CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.helpgenie.ai/api-reference/voices\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/voices.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.helpgenie.ai/#organization\",\"name\":\"Help Genie\",\"url\":\"https://docs.helpgenie.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/light.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f29d097a201254a8a750843d0d692c50\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.helpgenie.ai#website\",\"name\":\"Help Genie\",\"url\":\"https://docs.helpgenie.ai\",\"publisher\":{\"@id\":\"https://docs.helpgenie.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.helpgenie.ai/api-reference/voices#webpage\",\"url\":\"https://docs.helpgenie.ai/api-reference/voices\",\"name\":\"Voices\",\"description\":\"Browse and search voices, manage favorites, and track voice usage\",\"dateModified\":\"2026-08-18T07:21:51.435Z\",\"isPartOf\":{\"@id\":\"https://docs.helpgenie.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.helpgenie.ai/api-reference/voices#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.helpgenie.ai/api-reference/voices#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Help Genie\",\"item\":\"https://docs.helpgenie.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Voices\",\"item\":\"https://docs.helpgenie.ai/api-reference/voices\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.helpgenie.ai/api-reference/voices#article\",\"headline\":\"Voices\",\"name\":\"Voices\",\"description\":\"Browse and search voices, manage favorites, and track voice usage\",\"url\":\"https://docs.helpgenie.ai/api-reference/voices\",\"mainEntityOfPage\":{\"@id\":\"https://docs.helpgenie.ai/api-reference/voices#webpage\"},\"dateModified\":\"2026-08-18T07:21:51.435Z\",\"publisher\":{\"@id\":\"https://docs.helpgenie.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.helpgenie.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Help Genie\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Help Genie\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/voices.md","siteName":"Help Genie","nav":{"global":{"anchors":[{"anchor":"Help Genie Voice","icon":"microphone","href":"https://helpgenie.ai"},{"anchor":"Help Genie Mail","icon":"envelope","href":"https://mail.helpgenie.ai"},{"anchor":"Help Genie Outbound","icon":"phone","href":"https://outbound.helpgenie.ai"},{"anchor":"Help Genie Sync","icon":"arrows-rotate","href":"https://sync.helpgenie.ai"}]},"tabs":[{"tab":"Getting started","icon":"compass","pages":[{"title":"Getting started","href":""}]},{"tab":"API reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Making requests","href":"/api-reference/making-requests"},{"title":"Error handling","href":"/api-reference/errors"}]},{"group":"Public (unauthenticated)","pages":[{"title":"Public Genies","href":"/api-reference/public-genies"},{"title":"Public Help Hub","href":"/api-reference/public-help-hub"},{"title":"Activation (Public)","href":"/api-reference/activation"},{"title":"Help Hub","href":"/api-reference/help-hub"}]},{"group":"Agents","pages":[{"title":"Genies","href":"/api-reference/genies"},{"title":"Genie groups","href":"/api-reference/genie-groups"},{"title":"Conversations","href":"/api-reference/conversations"},{"title":"Genie Meetings","href":"/api-reference/genie-meetings"}]},{"group":"Knowledge","pages":[{"title":"Knowledge base","href":"/api-reference/knowledge-base"},{"title":"Knowledge Recommendations","href":"/api-reference/knowledge-recommendations"},{"title":"Document folders","href":"/api-reference/document-folders"},{"title":"Genie Documents","href":"/api-reference/genie-documents"}]},{"group":"CRM","pages":[{"title":"Leads","href":"/api-reference/leads"}]},{"group":"Marketplace","pages":[{"title":"Marketplace","href":"/api-reference/marketplace"}]},{"group":"Platform","pages":[{"title":"Profiles","href":"/api-reference/profiles"},{"title":"Teams","href":"/api-reference/teams"},{"title":"Activities","href":"/api-reference/activities"},{"title":"Goals","href":"/api-reference/goals"},{"title":"API keys","href":"/api-reference/api-keys"}]},{"group":"Telephony","pages":[{"title":"Phone numbers","href":"/api-reference/phone-numbers"},{"title":"QR codes","href":"/api-reference/qr-code"}]},{"group":"Worker genies","pages":[{"title":"Worker genies","href":"/api-reference/worker-genies"}]},{"group":"Quality \u0026 Compliance","pages":[{"title":"Brand Integrity","href":"/api-reference/brand-integrity"}]},{"group":"Access Control","pages":[{"title":"Genie Access","href":"/api-reference/genie-access"}]},{"group":"Intelligence","pages":[{"title":"Insights","href":"/api-reference/insights"}]},{"group":"Education","pages":[{"title":"Learn","description":"Access Learn Hub articles and track per-user reading progress for in-product education.","href":"/api-reference/learn"}]},{"group":"Voice","pages":[{"title":"Voices","href":"/api-reference/voices"},{"title":"Voice collections","description":"DEPRECATED — the voice-collections resource has been removed","href":"/api-reference/voice-collections"},{"title":"Preselected voices","href":"/api-reference/preselected-voices"},{"title":"Pronunciation Vaults","href":"/api-reference/pronunciation-vaults"}]},{"group":"Integrations","pages":[{"title":"Context Sources","href":"/api-reference/context-sources"},{"title":"Escalation Webhooks","href":"/api-reference/escalation-webhooks"},{"title":"Chat channels","href":"/api-reference/chat-channels"},{"title":"MCP connections","href":"/api-reference/mcp-connections"}]},{"group":"Expanded Platform","pages":[{"title":"Analytics","href":"/api-reference/analytics"},{"title":"Billing","href":"/api-reference/billing"},{"title":"Branding","href":"/api-reference/branding"},{"title":"Portals","href":"/api-reference/portals"},{"title":"Activation Packs","href":"/api-reference/activation-packs"},{"title":"Print Orders","href":"/api-reference/print-orders"},{"title":"Playbooks","href":"/api-reference/playbooks"},{"title":"Demo Genies","href":"/api-reference/demo-genies"},{"title":"Email Templates","href":"/api-reference/email-templates"},{"title":"Email Logs","href":"/api-reference/email-logs"},{"title":"System Emails","href":"/api-reference/system-emails"},{"title":"Generate Logo","href":"/api-reference/generate-logo"},{"title":"Capabilities","href":"/api-reference/capabilities"},{"title":"Agent mailboxes","href":"/api-reference/agent-mailboxes"},{"title":"Genie mailbox (self)","href":"/api-reference/agent-mailboxes-self"},{"title":"Mail tenant credentials","href":"/api-reference/mail-tenant-credentials"}]}]},{"tab":"Voice","icon":"microphone","pages":[{"title":"Voice","href":"/voice-guide/my-genies-list"}]},{"tab":"Mail","icon":"envelope","pages":[{"title":"Mail","href":"/mail-guide/introduction"}]},{"tab":"Outbound","icon":"phone","pages":[{"title":"Outbound","href":"/outbound-guide/introduction"}]},{"tab":"Sync","icon":"arrows-rotate","pages":[{"title":"Sync","href":"/sync-guide/introduction"}]}]},"basePath":"","title":"Voices - Help Genie","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}