Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Posts

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.
post/v1/posts/{postId}/update-metadata

Path parameters

postIdstring required

Zernio post ID, or "_" when using direct video ID mode

Request body

platform'youtube' required

The platform to update metadata on

videoIdstring

YouTube video ID (required for direct mode, ignored for post-based mode)

accountIdstring

Zernio social account ID (required for direct mode, ignored for post-based mode)

titlestring

New video title (max 100 characters for YouTube)

descriptionstring

New video description

tagsstring[]

Array of keyword tags (max 500 characters combined for YouTube)

categoryIdstring

YouTube video category ID

privacyStatus'public' | 'private' | 'unlisted'

Video privacy setting

thumbnailUrlstring uri

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.

madeForKidsboolean

COPPA compliance flag. Set true for child-directed content (restricts comments, notifications, ad targeting).

containsSyntheticMediaboolean

AI-generated content disclosure. Set true if the video contains synthetic content that could be mistaken for real. YouTube may add a label.

playlistIdstring

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

Metadata updated successfully

successboolean
messagestring
videoIdstring

Only present in direct video ID mode

updatedFieldsstring[]