Get shareable URLs for a session

GET

/sessions/{id}/share_url

Host only. Returns a watch URL for direct viewing, an embed URL, and a ready-to-use iframe HTML snippet for embedding on external sites.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200

application/json

Share URLs returned

Body

🟠403

🟠404

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/sessions//share_url' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "success": true,
    "data": {
        "watch_url": "https://viewer.example.com/sessions/uuid/watch",
        "embed_url": "https://viewer.example.com/embed/sessions/uuid",
        "embed_html": "<iframe src=\"https://viewer.example.com/embed/sessions/uuid\" style=\"width:100%;aspect-ratio:16/9;border:none;\" allow=\"autoplay; encrypted-media; fullscreen\" allowfullscreen></iframe>"
    },
    "timestamp": 0
}

Modified at 2026-02-10 08:33:01

Generate studio URL