---
title: "Initiate Call"
method: POST
path: "/video/call/initiate"
tags: ["video", "video"]
---

# Initiate Call

`POST /video/call/initiate`

Initiate a video/audio call between users.

Checks:
- User authentication (must be logged in)
- Call minutes quota (unless admin/premium)
- Caller identity verification (can't initiate as someone else)
- Relationship validation: Users must be friends OR have an accepted tutor-student relationship OR have a booking today
- Admins can call anyone (bypass relationship check)

## Headers

- `authorization` string, nullable

## Request body

- CallInitiateRequest
  - `caller_id` string, required
  - `callee_id` string, required
  - `call_type` string
  - `conversation_language` string, nullable
  - `transcription_language` string, nullable
  - `translation_language` string, nullable
  - `conversation_id` string, nullable
  - `transcription_enabled` boolean, nullable
  - `scheduled_duration_minutes` integer, nullable
  - `call_mode` string, nullable
  - `exchange_period_seconds` integer, nullable
  - `exchange_language_b` string, nullable
  - `language_for_practice` string, nullable
  - `learner_id` string, nullable
  - `teacher_id` string, nullable
  - `lesson_context` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/78f314acd8bf/schema)