VisionFaceTag vision.face-tag@1

Generated at from openvibe-contracts v0.419.0 and openvibe-sdk v0.161.0.

Version
1.0.0
Owner
vision
Visibility
first-party
Status
active
Compatibility
backward
Schema
https://openvibe.network/contracts/vision/face-tag.v1.json

vision.face-tag@1: one cast tag on a stream: which subject, which channel, which private media reference and when. GET /api/v1/faces/cast/tags lists the caller's own tags; revoking the cast consent removes them.

Fields

FieldTypeRequiredDescriptionConstraints
idstringyes
  • pattern ^ftg_[0-9A-HJKMNP-TV-Z]{26}$
channelstringyes
media_refstringyes
created_atstringyes
  • format date-time

Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: one
{
  "id": "ftg_01J8Z3Q4R5S6T7V8W9X0Y1Z2A4",
  "channel": "live:one",
  "media_ref": "media:a",
  "created_at": "2026-10-29T10:00:00.000Z"
}
Rejected: one
{
  "id": "ftg_1",
  "channel": "live:one",
  "media_ref": "media:a",
  "created_at": "2026-10-29T10:00:00.000Z"
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('vision.face-tag@1', value);   // { valid, errors: [{ path, message }] }