[{"data":1,"prerenderedAt":102},["ShallowReactive",2],{"reference-detail-delete_voice_api_v1_voice_delete":3,"developer-code-1bo9e31":100,"developer-code-nr2uht":101},{"tag":4,"sourceTag":4,"tagSlug":5,"method":6,"path":7,"slug":8,"summary":9,"description":10,"operationId":11,"groupOrder":12,"descriptionHtml":13,"parameters":14,"responses":27,"security":90,"codeSamples":93},"Voices","voices","DELETE","\u002Fapi\u002Fv1\u002Fvoice","delete-voice","Delete voice","Delete one of your cloned voices by `voice_id`. Only voices you created can be removed.\n\nAgent safety: require an explicit user request and confirmation immediately before calling this destructive operation.","delete_voice_api_v1_voice_delete",30,"\u003Cp>Delete one of your cloned voices by \u003Ccode>voice_id\u003C\u002Fcode>. Only voices you created can be removed.\u003C\u002Fp>\u003Cp>Agent safety: require an explicit user request and confirmation immediately before calling this destructive operation.\u003C\u002Fp>",[15,22],{"name":16,"in":17,"required":18,"description":19,"type":20,"example":21},"X-API-Key","header",true,"Your VisionStory API key (`sk-vs-...`), kept server-side. Create or manage keys in [API keys](\u002Fapi-keys) (Pro plan and up).","string","sk-vs-your-api-key",{"name":23,"in":24,"required":18,"description":25,"type":20,"example":26},"voice_id","query","Id of the cloned voice to delete, as returned by POST \u002Fapi\u002Fv1\u002Fvoice or listed under `my_voices` in GET \u002Fapi\u002Fv1\u002Fvoices. Only voices you created can be removed.","voice_123456",[28,60],{"status":29,"description":30,"contentType":31,"schema":32,"example":57},"200","Successful Response","application\u002Fjson",{"type":33,"description":34,"nullable":35,"properties":36},"BaseSuccessResponse_DeleteResponse_","",false,[37,47,52],{"name":38,"required":18,"type":39,"description":40,"nullable":18,"properties":41},"data","DeleteResponse | null","Common response body for DELETE endpoints (avatar \u002F voice \u002F video \u002F ai_video \u002F asset).",[42],{"name":43,"required":35,"type":44,"description":45,"nullable":35,"default":18,"properties":46},"deleted","boolean","Always `true` when the request succeeded — the resource has been removed and no longer appears in list endpoints. Deletes are idempotent: deleting an already-removed resource still returns `true`.",[],{"name":48,"required":35,"type":20,"description":49,"nullable":35,"default":50,"properties":51},"message","Human-readable status message; `\"success\"` on a successful call.","success",[],{"name":53,"required":18,"type":54,"description":55,"nullable":35,"properties":56},"server_time","string · date-time","Server-side timestamp when the response was produced, in ISO 8601 format (UTC).",[],{"data":58,"server_time":59,"message":50},{"deleted":18},"2026-08-24T08:00:00Z",{"status":61,"description":62,"contentType":31,"schema":63,"example":87},"default","Error response. All failures share one envelope: an `error` object with a numeric `code`, a human-readable `message`, an optional `details` string, and an optional `hint` giving an actionable next step (useful for AI agents).",{"type":64,"description":34,"nullable":35,"properties":65},"ErrorResponse",[66],{"name":67,"required":18,"type":68,"description":34,"nullable":35,"properties":69},"error","ErrorDetail",[70,75,80,84],{"name":71,"required":18,"type":72,"description":73,"nullable":35,"properties":74},"code","integer","Machine-readable error code. Mirrors the HTTP status for transport-level failures (e.g. 401, 404, 422, 500) and may carry a business-specific code otherwise.",[],{"name":76,"required":35,"type":77,"description":78,"nullable":18,"properties":79},"details","string | null","Optional structured detail about the failure, e.g. a JSON string of per-field validation errors on a 422. Absent when there is nothing extra to report.",[],{"name":81,"required":35,"type":77,"description":82,"nullable":18,"properties":83},"hint","Actionable next step for resolving the error, written for both humans and AI agents (e.g. how to fix the request, or where to obtain an API key). May be absent.",[],{"name":48,"required":18,"type":20,"description":85,"nullable":35,"properties":86},"Human-readable explanation of what went wrong. Safe to log or surface to end users; not localized.",[],{"error":88},{"code":89,"message":20,"details":20,"hint":20},1,[91],{"APIKeyHeader":92},[],[94,97],{"lang":95,"source":96},"Python","import os\nimport requests\n\nheaders = {\"X-API-Key\": os.environ[\"VISIONSTORY_API_KEY\"]}\nrequests.delete(\n    'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvoice?voice_id=xxxx', headers=headers\n)",{"lang":98,"source":99},"cURL","curl -X 'DELETE' \\\n      'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvoice?voice_id=xxxx' \\\n      -H 'accept: application\u002Fjson' \\\n      -H 'X-API-Key: $VISIONSTORY_API_KEY'","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"data\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">    \"deleted\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">true\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">  },\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"server_time\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"2026-08-24T08:00:00Z\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"message\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"success\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FF7B72\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> os\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FF7B72\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> requests\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">headers \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> {\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"X-API-Key\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: os.environ[\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"VISIONSTORY_API_KEY\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">]}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">requests.delete(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#A5D6FF\">    'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvoice?voice_id=xxxx'\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">headers\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">headers\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1788166855864]