---
title: "New Session"
method: POST
path: "/v1/streaming.new"
tags: ["Streaming"]
---

# New Session

`POST /v1/streaming.new`

This endpoint is used to initiate a new streaming session.

## Request body

- object
  - `quality` string
  - `avatar_id` string — ID of the Interactive Avatar you would like to use with the Streaming API
  - `voice_name` string — voice to use
  - `voice` object
    - `voice_id` string
    - `rate` number, float
    - `emotion` string
  - `knowledge_base` string — Knowledge Base prompt used for chat task type.
  - `video_encoding` string
  - `disable_idle_timeout` boolean — By default session has a 2 minute idle timeout, setting to true disables it
  - `version` string

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/heygen/apis/heygen-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-api/revisions/2f19176d6d56/schema)