---
title: "vision.face.cast.match · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/vision.face.cast.match"
updated: null
---

# vision.face.cast.match · OpenVibe.Services

HTML: [vision.face.cast.match · OpenVibe.Services](https://openvibe.services/docs/capabilities/vision.face.cast.match)

# `vision.face.cast.match`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Not grantable to apps (active, first-party).

Match faces against one channel's opted-in adult cast roster for OpenVibe.Live: POST /api/v1/faces/cast/match. The caller is the Live service token scoped to that channel (its channel\_id claim must equal the body's channel) and must hold this capability. A non-consented person is never matched and the answer does not say whether they exist.

- Owner: vision (token audience `openvibe.vision`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: none
- Quota class: vision-face
- Permissions: vision:face:cast:match
- Input: [vision.face-cast-match-request@1](/docs/contracts/vision.face-cast-match-request)
- Output: vision.face-cast-match@1
- Events: vision.result.ready
- Implemented by: - `POST /api/v1/faces/cast/match`

[These routes in the API explorer](/docs/api/vision#cap-vision.face.cast.match)