Hanzo AIDocs
Sign inAPI key

Update videos

Update one video.

PATCH /v1/ai/videos/{owner}/{name}

AI → · All API references → · Get started →

Addresshttps://api.hanzo.ai/v1/ai/videos/{owner}/{name}
MethodPATCH
Operationpatch_ai_videos_by_owner_by_name
AuthAuthorization: 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).

FieldInTypeRequiredDescription
ownerpathstringyes
namepathstringyes
(body)bodyobjectyes

Response

StatusBodyMeaning
200Envelope.
401—No credential, or one this service does not accept.
403—A valid credential that may not do this.

200 body — 77 fields.

FieldInTypeAlwaysDescription
databodyany—The operation's own result.
data2bodyany—A second result the operation defines, when it has one.
msgbodystringyesEmpty on success, the reason on failure.
statusbodystringyesOne of ok, error.
data.audioUrlbodystring—
data.classbodystring—
data.coverUrlbodystring—
data.createdTimebodystring—
data.dataUrlbodystring—
data.dataUrlsbodystring[]—
data.descriptionbodystring—
data.displayNamebodystring—
data.downloadUrlbodystring—
data.editModebodystring—
data.excellentCountbodyinteger—
data.gradebodystring—
data.grade2bodystring—
data.isPublicbodyboolean—
data.keywordsbodystring[]—
data.labelCountbodyinteger—
data.labelsbodyLabel[]—
data.labels[].endTimebodynumber—
data.labels[].idbodystring—
data.labels[].speakerbodystring—
data.labels[].startTimebodynumber—
data.labels[].tag1bodystring—
data.labels[].tag2bodystring—
data.labels[].tag3bodystring—
data.labels[].textbodystring—
data.labels[].typebodystring—
data.labels[].userbodystring—
data.lessonbodystring—
data.namebodystring—
data.ownerbodystring—
data.playAuthbodystring—
data.remarksbodyRemark[]—
data.remarks[].isPublicbodyboolean—
data.remarks[].scorebodystring—
data.remarks[].textbodystring—
data.remarks[].timestampbodystring—
data.remarks[].userbodystring—
data.remarks2bodyRemark[]—
data.remarks2[].isPublicbodyboolean—
data.remarks2[].scorebodystring—
data.remarks2[].textbodystring—
data.remarks2[].timestampbodystring—
data.remarks2[].userbodystring—
data.reviewStatebodystring—
data.schoolbodystring—
data.segmentCountbodyinteger—
data.segmentsbodyLabel[]—
data.segments[].endTimebodynumber—
data.segments[].idbodystring—
data.segments[].speakerbodystring—
data.segments[].startTimebodynumber—
data.segments[].tag1bodystring—
data.segments[].tag2bodystring—
data.segments[].tag3bodystring—
data.segments[].textbodystring—
data.segments[].typebodystring—
data.segments[].userbodystring—
data.stagebodystring—
data.statebodystring—
data.subjectbodystring—
data.tagbodystring—
data.tagOnPausebodyboolean—
data.task1bodystring—
data.task2bodystring—
data.task3bodystring—
data.templatebodystring—
data.topicbodystring—
data.typebodystring—
data.unitbodystring—
data.videoIdbodystring—
data.videoLengthbodystring—
data.wordCountMapbodyobject—
data.wordCountMap.*bodyinteger—

Failure carries the platform error shape — see Errors.

Examples

hanzo ai videos owner update <owner> <name>
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' });
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')
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
}
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?;
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();
curl -X PATCH https://api.hanzo.ai/v1/ai/videos/<owner>/<name> \
  -H "Authorization: Bearer $HANZO_API_KEY"

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 · All Hanzo APIs · Interactive reference

Was this page useful?
PreviousUpdate vectorsNextUpdate workflows