Add product video
Attach a YouTube video link to the product. The URL must be one a video id can be parsed from (watch / youtu.be / embed); other URLs are rejected with 422. Requires the organization.contribute_organization permission on the membership.
Authorizations
Path Parameters
UUID of the organization that owns the product.
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$GTIN-8/12/13/14 of the target product. Normalized to GTIN-14 by zero-padding before lookup.
^\d{8,14}$Body
Request body for adding a YouTube video link to a product.
YouTube video URL. Must be a watch / youtu.be / embed URL a video id can be parsed from.
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Caption for the video. Empty string when not specified.
255"Product overview"
Free-text description of the video. Empty string when not specified.
Display order within the product's video list. Lower numbers appear first; ties break on -created.
x >= 0Response
Created
A single YouTube video attached to a product.
URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$YouTube video URL as entered.
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Caption for the video. Empty string when not set.
255Free-text description of the video. Empty string when not set.
Display order within the product's video list. Lower numbers appear first.
x >= 0ISO-8601 UTC timestamp of when the video was added.
Parsed YouTube video id (e.g. dQw4w9WgXcQ). Null when the URL couldn't be parsed.
YouTube embed URL derived from video_id. Null when the URL couldn't be parsed.
YouTube thumbnail URL derived from video_id. Null when the URL couldn't be parsed.