Skip to main content
Programmatic equivalent of the dashboard’s products/<gtin>/videos/ page (and its videos/new/, videos/<id>/edit/, videos/<id>/delete/ sub-pages).

​
When to use

  • A brand owner needs to attach a YouTube video (demo, unboxing, how-to) to a product, or update/remove one already attached.

​
Auth

X-API-Key header or OAuth token with dashboard:write scope. The caller must be a member of organization_id and hold the organization.contribute_organization permission; the product must be owned by that organization.

​
Flow

  • List — paginated, ordered by ascending priority, then most-recent.
  • Add — the URL must be a form a video id can be parsed from (watch, youtu.be, or embed links); other URLs are rejected with 422.
  • Update / Delete — edit or remove a single row by id; video_id must belong to the targeted product.
Returns 201 on add, 403 for a caller without the contribute permission, 404 for a GTIN/video not owned by organization_id, 422 for an unparsable URL.

​
Notes

Writes go through an audited @org_action service — the direct form.save() this dashboard page used before C-4070 is gone.