Skip to main content

Import Provider Tags

POST 
/v2/videos/:video_id/provider-tags

Import importer-sourced tags (e.g. VoxPopMe vpm.*, cohort demo.* / survey.*) onto a video — the API path for external-source data that POST /v2/videos/{id}/tags forbids.

Unlike the user endpoint this writes non-user-editable registered keys with an importer.* source (so customer-solutions data lands through the backend — correct DB/creds + registry validation — instead of a direct Firestore write). Owner-or-admin only (same access check as POST /tags).

Bounded so it can't forge data:

  • source must be an importer.* value,
  • every key must resolve in the registry, and
  • every key's category must be in IMPORTABLE_CATEGORIES (provider / demographic / survey — external-source data nothing in the pipeline owns). system.* stays rejected so an owner token can't write pipeline-owned tags through this path; label.* / user.* stay rejected because user data belongs on POST /v2/videos/{id}/tags with user-source semantics.

Idempotent — each key is an upsert via set_tag.

Request​

Responses​

Successful Response