Update an SRT Flow

PATCH

flows

{flow_id}

curl -X PATCH "https://client.camb.ai/apis/flows/42" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "active": false }'

import requests

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

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

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Overview

Updates a flow. Only label and active can be changed. To change a flow’s mode, URLs, or failover setup, delete it and create a new one. Setting active controls whether the flow’s SRT endpoint is online. Inactive flows keep their URLs and key, so you can take an endpoint offline between events without reconfiguring your encoders.

curl -X PATCH "https://client.camb.ai/apis/flows/42" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "active": false }'

import requests

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

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

Errors

404 - No flow with this ID belongs to your team.
422 - Validation error (e.g. a label already used by another of your team’s flows).

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.

Body

application/json

Partial update of a flow. Only label and active can change; to change URLs, mode or failover, delete and recreate the flow.

label

string | null

New label (unique within your team).

active

boolean | null

Set true to bring the flow's relay online, false to take it offline.

Response

The updated 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.

Last modified on July 24, 2026

Delete an SRT FlowDelete a stream flow and shut down its SRT endpoint.

curl -X PATCH "https://client.camb.ai/apis/flows/42" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "active": false }'

import requests

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

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

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Update an SRT Flow

Overview

Errors

Authorizations

Path Parameters

Body

Response

​Overview

​Errors

​Related endpoints

Authorizations

Path Parameters

Body

Response

Overview

Errors

Related endpoints