Update an SRT Flow
Rename a stream flow, bring its endpoint online or offline, or change its egress destinations.
PATCH
Overview
Updates a flow. Onlylabel, active, egress_primary_url and
egress_backup_url can be changed. To change a flow’s mode, upstream URLs,
failover setup, or region, 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.
The egress URLs follow the same rules as on create. Fields you
omit keep their value, and null removes a destination. Removing
egress_primary_url also requires removing egress_backup_url. Any egress
change briefly reconnects both destinations.
Stop pushing to the backup destination
Errors
404- No flow with this ID belongs to your team.422- Validation error (e.g. alabelalready used by another of your team’s flows, an invalid egress URL, or a backup egress destination without a primary).
Related endpoints
Authorizations
Body
application/json
Partial update of a flow. Only label, active and the egress URLs can change; to change the upstream URLs, mode, failover or region, delete and recreate the flow.
Response
The updated flow.
Last modified on October 28, 2026