[{"data":1,"prerenderedAt":114},["ShallowReactive",2],{"reference-detail-en-delete_video_api_v1_video_delete":3,"developer-code-57rpc5":112,"developer-code-1wdzc54":113},{"tag":4,"sourceTag":5,"tagSlug":6,"method":7,"path":8,"slug":9,"summary":10,"description":11,"operationId":12,"groupOrder":13,"descriptionHtml":14,"parameters":15,"responses":28,"security":99,"codeSamples":102},"Talking Avatar Video","Videos","videos","DELETE","\u002Fapi\u002Fv1\u002Fvideo","delete-video","Delete video","Delete one of your videos by `video_id`. Only videos you created are affected, and deletion cannot\nbe undone.\n\nAgent safety: require an explicit user request and confirmation immediately before calling this destructive operation.","delete_video_api_v1_video_delete",10,"\u003Cp>Delete one of your videos by \u003Ccode>video_id\u003C\u002Fcode>. Only videos you created are affected, and deletion cannot be undone.\u003C\u002Fp>\u003Cp>Agent safety: require an explicit user request and confirmation immediately before calling this destructive operation.\u003C\u002Fp>",[16,23],{"name":17,"in":18,"required":19,"description":20,"type":21,"example":22},"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":24,"in":25,"required":19,"description":26,"type":21,"example":27},"video_id","query","Id of the video to delete, as returned by POST \u002Fapi\u002Fv1\u002Fvideo or GET \u002Fapi\u002Fv1\u002Fvideos. Only videos you created are affected; deletion is permanent.","video_123456",[29,68],{"status":30,"description":31,"contentType":32,"schema":33,"example":58,"examples":61,"headers":67},"200","Successful Response","application\u002Fjson",{"type":34,"description":35,"nullable":36,"properties":37},"BaseSuccessResponse_DeleteResponse_","",false,[38,48,53],{"name":39,"required":19,"type":40,"description":41,"nullable":19,"properties":42},"data","DeleteResponse | null","Common response body for DELETE endpoints (avatar \u002F voice \u002F video \u002F ai_video \u002F asset).",[43],{"name":44,"required":36,"type":45,"description":46,"nullable":36,"default":19,"properties":47},"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":49,"required":36,"type":21,"description":50,"nullable":36,"default":51,"properties":52},"message","Human-readable status message; `\"success\"` on a successful call.","success",[],{"name":54,"required":19,"type":55,"description":56,"nullable":36,"properties":57},"server_time","string · date-time","Server-side timestamp when the response was produced, in ISO 8601 format (UTC).",[],{"data":59,"message":51,"server_time":60},{"deleted":19},"2026-09-04T00:00:00Z",[62],{"name":51,"description":63,"summary":64,"value":65},"Examples illustrate the response structure, not live account data or a pricing quote. IDs and URLs are placeholders. Query model discovery and cost endpoints for current availability and prices.","Successful response",{"data":66,"message":51,"server_time":60},{"deleted":19},[],{"status":69,"description":70,"contentType":32,"schema":71,"example":95,"headers":98},"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":72,"description":35,"nullable":36,"properties":73},"ErrorResponse",[74],{"name":75,"required":19,"type":76,"description":35,"nullable":36,"properties":77},"error","ErrorDetail",[78,83,88,92],{"name":79,"required":19,"type":80,"description":81,"nullable":36,"properties":82},"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":84,"required":36,"type":85,"description":86,"nullable":19,"properties":87},"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":89,"required":36,"type":85,"description":90,"nullable":19,"properties":91},"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":49,"required":19,"type":21,"description":93,"nullable":36,"properties":94},"Human-readable explanation of what went wrong. Safe to log or surface to end users; not localized.",[],{"error":96},{"code":97,"message":21,"details":21,"hint":21},1,[],[100],{"APIKeyHeader":101},[],[103,106,109],{"lang":104,"source":105},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\nresult = client.delete_video(\"video_123456\")\nprint(result)",{"lang":107,"source":108},"REST","import os\nimport requests\n\nheaders = {\"X-API-Key\": os.environ[\"VISIONSTORY_API_KEY\"]}\nrequests.delete(\n    'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvideo?video_id=xxxx', headers=headers\n)",{"lang":110,"source":111},"cURL","curl -X 'DELETE' \\\n      'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fvideo?video_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:#FF7B72\">from\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> visionstory \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">client \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient.from_env()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">result \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> client.delete_video(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"video_123456\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79C0FF\">print\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(result)\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:#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\">  \"message\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"success\"\u003C\u002Fspan>\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-09-04T00:00:00Z\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1790231923843]