---
title: "Create streaming session (deprecated)"
method: POST
path: "/session-storage/sessions"
tags: ["Sessions API"]
deprecated: true
---

# Create streaming session (deprecated)

`POST /session-storage/sessions`

> **Deprecated.**

[DEPRECATED] Use /session-storage/session instead.

Endpoint provides functionality to initiate streaming sessions. It creates a unique `Room` at the WebRTC server for upcoming audio publishing and registers connection at the WebSocket translation management API. JWT access token received in response should be used for both connecting to the WebRTC server and WebSocket translation management API.

Notice, the JWT access token contains permissions, which may lead to restriction of several API functionalities.

Streaming session allows publishing RTC stream to the server, receiving translated audio stream, and managing translation options through WebSocket API.

### References
- [Translation management WebSocket API](https://docs.palabra.ai/docs/streaming_api/management)
- [Streaming session](https://docs.palabra.ai/docs/streaming_api/session)

## Request body

- object
  - `data` CreateSessionRequestData, required
    - `publisher_count` integer — Number of publisher tokens to generate
    - `subscriber_count` integer — **Deprecated.** Subscriber tokens will be removed in the next release. Set to 0 or omit.
    - `publisher_can_subscribe` boolean — Indicates if publisher can also subscribe to the stream. Disabling this option may help with gstreamer livekitwebrtcsink issues. https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/issues/443
    - `intent` 'api' | 'broadcaster' | 'desktop' | 'event' | 'agora' | 'captions' | 'bot_conversational' | 'bot_presentation' — Intent of the session. Used for analytics and debugging purposes.

## Response `200`

Session created successfully.

- object
  - `ok` boolean, required
  - `data` CreateSessionResponseData, required — Streaming session response data. **Notice**, address provided in the response example are **placeholders** and will differ in real response.
    - `publisher` string[], required — JWT used to connect to the WebRTS server and Translation management WebSocket API
    - `subscriber` string[], required — **Deprecated.** The `subscriber` field will be removed in the next release.
    - `room_name` string, required — Room name to join WebRTC server
    - `stream_url` string, required — Streaming API URL to publish a stream
    - `control_url` string, required — WebSocket API URL to manage translation options
    - `intent` 'api' | 'broadcaster' | 'desktop' | 'event' | 'agora' | 'captions' | 'bot_conversational' | 'bot_presentation', required — Intent of the session. Used for analytics and debugging purposes.
    - `id` string, required — Publisher session identifier.
    - `aggregation_id` string — Unique id per group of sessions to display aggregated billing details
    - `organization` string, required — Casdoor organization that owns the session.

## Other responses

- `default` — Default Response

---

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