---
title: "Join Video Screening"
method: POST
path: "/api/interviews/{interview_id}/join-video"
tags: ["Interviews"]
---

# Join Video Screening

`POST /api/interviews/{interview_id}/join-video`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/interviews/{interview_id}/join-video`
- Auth: none declared

Create a Vapi web call for video screening - called when candidate clicks 'Join'.

This endpoint is called when the candidate is ready to join the video screening.
It creates a Vapi web call on-demand (rooms expire quickly, ~30 seconds).

The candidate does NOT need to be authenticated - they join via a link.

Returns:
    webCallUrl: URL to redirect candidate to (vapi.daily.co room)

## Path parameters

- `interview_id` string, uuid, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)
