---
title: "Initialize the browser emulator instance"
method: POST
path: "/instance/initialize"
tags: ["Instance"]
---

# Initialize the browser emulator instance

`POST /instance/initialize`

## Request body

- InitializePost
  - `browserVideo` union — Browser video configuration
    - object
      - `videoType` 'custom', required
      - `customVideo` object, required
        - `videoUrl` string, uri
        - `audioUrl` string, uri
    - object
      - `videoType` 'bunny' | 'interview' | 'game', required
      - `videoInfo` object, required
        - `width` integer
        - `height` integer
        - `fps` integer
  - `vnc` boolean
  - `awsAccessKey` string
  - `awsSecretAccessKey` string
  - `s3BucketName` string
  - `s3Region` string
  - `s3Host` string
  - `s3HostAccessKey` string
  - `s3HostSecretAccessKey` string
  - `legacyMode` boolean
  - `elasticSearchHost` string
  - `elasticSearchUserName` string
  - `elasticSearchPassword` string
  - `elasticSearchIndex` string

## Response `200`

Instance initialized successfully

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/openvidu/apis/browser-emulator-api.md) · [All operations](https://skmtc.dev/openvidu/apis/browser-emulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openvidu/browser-emulator-api/revisions/18732332a4cb/schema)