---
title: "Start Interview Screen Share"
method: POST
path: "/v1/interview/session/{session_id}/screen-shares/start"
tags: ["interview-realtime"]
---

# Start Interview Screen Share

`POST /v1/interview/session/{session_id}/screen-shares/start`

## Path parameters

- `session_id` string, required

## Query parameters

- `token` string, nullable

## Request body

- ScreenShareStartRequest
  - `request_id` string, nullable
  - `prompt` string, nullable
  - `reason` string, nullable

## Response `200`

Successful Response

- ScreenShareOut
  - `id` string, uuid, required
  - `status` string, required
  - `request_id` string, nullable
  - `started_at` string, date-time, nullable
  - `stopped_at` string, date-time, nullable
  - `duration_seconds` integer, nullable
  - `recording_mime_type` string, nullable
  - `recording_size_bytes` integer, nullable
  - `recording_error` string, nullable
  - `expected_chunk_count` integer, nullable
  - `uploaded_bytes` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)