Get an SRT Flow

{ "id": 123, "label": "<string>", "failover": true, "active": true, "team_id": 123, "key": "<string>", "play_url": "<string>", "push_urls": [ { "url": "<string>" } ], "passphrase": "<string>" }

Overview

Returns the full details of one flow, including its play_url, push_urls, and access key.

curl -X GET "https://client.camb.ai/apis/flows/42" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://client.camb.ai/apis/flows/42",
    headers={"x-api-key": "YOUR_API_KEY"},
)

response.raise_for_status()
print(response.json())

Related endpoints

Authorizations

x-api-key

string

header

required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Path Parameters

flow_id

integer

required

Identifier of the flow.

Response

The flow.

integer

Flow identifier.

label

string

mode

enum<string>

caller: Camb.ai connects out to your SRT endpoint (primary_url) and re-serves it. listener: Camb.ai hosts an SRT endpoint that your encoder pushes to.

Available options:

caller,

listener

failover

boolean

active

boolean

Whether the flow's relay is currently online.

team_id

integer

key

string

Access key embedded in the flow's URLs.

play_url

string

SRT URL the flow serves. Use it as source_stream.url or as a target_streams[].url, or play it directly.

push_urls

PushUrl · object[]

SRT URLs to push into (listener mode). Empty for caller flows.

Hide child attributes

push_urls.role

enum<string>

Which leg of the flow this URL feeds.

Available options:

primary,

backup

push_urls.url

string

SRT URL to push to.

passphrase

string | null

The flow's SRT encryption passphrase, when one is set.

{ "id": 123, "label": "<string>", "failover": true, "active": true, "team_id": 123, "key": "<string>", "play_url": "<string>", "push_urls": [ { "url": "<string>" } ], "passphrase": "<string>" }

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Get an SRT Flow

Overview

Errors

Authorizations

Path Parameters

Response

​Overview

​Errors

​Related endpoints

Authorizations

Path Parameters

Response

Overview

Errors

Related endpoints