Update post metadata
Updates metadata of a published video on the specified platform without re-uploading. Currently only supported for YouTube. At least one updatable field is required. Two modes: 1. Post-based (video published through Zernio): pass the Zernio postId in the URL and platform in the body. 2. Direct video ID (video uploaded outside Zernio, e.g. directly to YouTube): use _ as the postId, and pass videoId + accountId + platform in the body. The accountId is the Zernio social account ID for the connected YouTube channel.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Zernio post ID, or "_" when using direct video ID mode
The platform to update metadata on
"youtube"YouTube video ID (required for direct mode, ignored for post-based mode)
Zernio social account ID (required for direct mode, ignored for post-based mode)
New video title (max 100 characters for YouTube)
length <= 100New video description
Array of keyword tags (max 500 characters combined for YouTube)
YouTube video category ID
Video privacy setting
"public" | "private" | "unlisted"Public URL of a custom thumbnail image (JPEG, PNG, or GIF, max 2 MB, recommended 1280x720). Works on any video you own, including existing videos not published through Zernio. The channel must be verified (phone verification) to set custom thumbnails.
uriCOPPA compliance flag. Set true for child-directed content (restricts comments, notifications, ad targeting).
AI-generated content disclosure. Set true if the video contains synthetic content that could be mistaken for real. YouTube may add a label.
YouTube playlist ID to add the video to (e.g. 'PLxxxxxxxxxxxxx'). Use GET /v1/accounts/{id}/youtube-playlists to list available playlists. Only playlists owned by the channel are supported.
Response Body
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.posts.updatePostMetadata({ path: { postId: 'post_abc123', }, body: { platform: 'youtube', },});console.log(data);{
"success": true,
"message": "YouTube video metadata updated successfully",
"updatedFields": [
"title",
"description",
"tags"
]
}{
"error": "Unauthorized"
}{
"error": "Not found"
}