# Update videos URL: https://docs.hanzo.ai/docs/openapi/ai/patch-ai-videos-by-owner-by-name > Update one video. `PATCH /v1/ai/videos/{owner}/{name}` > [AI →](https://docs.hanzo.ai/docs/openapi/ai) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides) | | | | ------------- | -------------------------------------------------- | | **Address** | `https://api.hanzo.ai/v1/ai/videos/{owner}/{name}` | | **Method** | `PATCH` | | **Operation** | `patch_ai_videos_by_owner_by_name` | | **Auth** | `Authorization: Bearer $HANZO_API_KEY` | Update one video. PATCH and PUT reach the same handler, which has always taken a whole object. ## Request 3 fields, body `application/json` (required). | Field | In | Type | Required | Description | | -------- | ---- | ------ | -------- | ----------- | | `owner` | path | string | yes | | | `name` | path | string | yes | | | `(body)` | body | object | yes | | ## Response | Status | Body | Meaning | | ------ | ---- | --------------------------------------------------- | | `200` | | Envelope. | | `401` | — | No credential, or one this service does not accept. | | `403` | — | A valid credential that may not do this. | `200` body — 77 fields. | Field | In | Type | Always | Description | | --------------------------- | ---- | --------- | ------ | ------------------------------------------------------- | | `data` | body | any | — | The operation's own result. | | `data2` | body | any | — | A second result the operation defines, when it has one. | | `msg` | body | string | yes | Empty on success, the reason on failure. | | `status` | body | string | yes | One of `ok`, `error`. | | `data.audioUrl` | body | string | — | | | `data.class` | body | string | — | | | `data.coverUrl` | body | string | — | | | `data.createdTime` | body | string | — | | | `data.dataUrl` | body | string | — | | | `data.dataUrls` | body | string\[] | — | | | `data.description` | body | string | — | | | `data.displayName` | body | string | — | | | `data.downloadUrl` | body | string | — | | | `data.editMode` | body | string | — | | | `data.excellentCount` | body | integer | — | | | `data.grade` | body | string | — | | | `data.grade2` | body | string | — | | | `data.isPublic` | body | boolean | — | | | `data.keywords` | body | string\[] | — | | | `data.labelCount` | body | integer | — | | | `data.labels` | body | Label\[] | — | | | `data.labels[].endTime` | body | number | — | | | `data.labels[].id` | body | string | — | | | `data.labels[].speaker` | body | string | — | | | `data.labels[].startTime` | body | number | — | | | `data.labels[].tag1` | body | string | — | | | `data.labels[].tag2` | body | string | — | | | `data.labels[].tag3` | body | string | — | | | `data.labels[].text` | body | string | — | | | `data.labels[].type` | body | string | — | | | `data.labels[].user` | body | string | — | | | `data.lesson` | body | string | — | | | `data.name` | body | string | — | | | `data.owner` | body | string | — | | | `data.playAuth` | body | string | — | | | `data.remarks` | body | Remark\[] | — | | | `data.remarks[].isPublic` | body | boolean | — | | | `data.remarks[].score` | body | string | — | | | `data.remarks[].text` | body | string | — | | | `data.remarks[].timestamp` | body | string | — | | | `data.remarks[].user` | body | string | — | | | `data.remarks2` | body | Remark\[] | — | | | `data.remarks2[].isPublic` | body | boolean | — | | | `data.remarks2[].score` | body | string | — | | | `data.remarks2[].text` | body | string | — | | | `data.remarks2[].timestamp` | body | string | — | | | `data.remarks2[].user` | body | string | — | | | `data.reviewState` | body | string | — | | | `data.school` | body | string | — | | | `data.segmentCount` | body | integer | — | | | `data.segments` | body | Label\[] | — | | | `data.segments[].endTime` | body | number | — | | | `data.segments[].id` | body | string | — | | | `data.segments[].speaker` | body | string | — | | | `data.segments[].startTime` | body | number | — | | | `data.segments[].tag1` | body | string | — | | | `data.segments[].tag2` | body | string | — | | | `data.segments[].tag3` | body | string | — | | | `data.segments[].text` | body | string | — | | | `data.segments[].type` | body | string | — | | | `data.segments[].user` | body | string | — | | | `data.stage` | body | string | — | | | `data.state` | body | string | — | | | `data.subject` | body | string | — | | | `data.tag` | body | string | — | | | `data.tagOnPause` | body | boolean | — | | | `data.task1` | body | string | — | | | `data.task2` | body | string | — | | | `data.task3` | body | string | — | | | `data.template` | body | string | — | | | `data.topic` | body | string | — | | | `data.type` | body | string | — | | | `data.unit` | body | string | — | | | `data.videoId` | body | string | — | | | `data.videoLength` | body | string | — | | | `data.wordCountMap` | body | object | — | | | `data.wordCountMap.*` | body | integer | — | | Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors). ## Examples **CLI** ```bash hanzo ai videos owner update ``` **SDK** **.ts** ```ts import { Configuration, AiApi } from 'hanzoai'; const api = new AiApi(new Configuration({ accessToken: process.env.HANZO_API_KEY })); const { data } = await api.patchAiVideosByOwnerByName({ owner: 'owner', name: 'name' }); ``` **.py** ```python from hanzoai.cloud import ApiClient, Configuration from hanzoai.cloud.api import AiApi client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"])) result = AiApi(client).patch_ai_videos_by_owner_by_name(owner='owner', name='name') ``` **.go** ```go cfg := hanzoai.NewConfiguration() cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY")) client := hanzoai.NewAPIClient(cfg) resp, _, err := client.AiAPI.PatchAiVideosByOwnerByName(context.Background()).Execute() if err != nil { return err } ``` **.rs** ```rust use hanzo_client::apis::{configuration::Configuration, ai_api}; let mut cfg = Configuration::new(); cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok(); let result = ai_api::patch_ai_videos_by_owner_by_name(&cfg, Default::default()).await?; ``` **.java** ```java import ai.hanzo.cloud.ApiClient; import ai.hanzo.cloud.api.AiApi; ApiClient client = new ApiClient(); client.setBearerToken(System.getenv("HANZO_API_KEY")); var result = new AiApi(client).patchAiVideosByOwnerByName(); ``` **HTTP** ```bash curl -X PATCH https://api.hanzo.ai/v1/ai/videos// \ -H "Authorization: Bearer $HANZO_API_KEY" ``` **MCP** MCP declares no tool for **ai** — `tools/list` on `https://api.hanzo.ai/v1/mcp` names the products it does reach. Use HTTP or an SDK. --- [AI API](https://docs.hanzo.ai/docs/openapi/ai) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)