Posts

Update post metadata

Changed on

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 account ID for the connected YouTube channel.
post/v1/posts/{postId}/update-metadata

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/posts/{postId}/update-metadata
  • Auth: HTTP bearer

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 account ID. Required for direct mode. In post-based mode, picks which account's copy to update when the post was published to several accounts on this platform (required in that case).

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 50 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. If the thumbnail cannot be set (YouTube refuses it, for example a channel without the custom-thumbnail permission or a video not owned by the connected channel, or the image URL cannot be fetched or is not a supported format or size), the request answers 400 with the reason and no field is updated. A YouTube thumbnail rate limit (uploadRateLimitExceeded) answers 429; retry later, not immediately, because retries keep the channel over its limit. Any other temporary YouTube or network failure answers 500 and can be retried.

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[]

Changes

  • 39b57979b4eaRevision changes
    • info

      added the non-success response with the status

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status