Partially updates an SRT source. Only deactivated sources can be updated.
Authorizations
OAuth2 bearer token in the Authorization header
Path Parameters
Unique identifier of a Source
Body
All fields are optional; supplied fields are updated.
SRT receiver configuration. Validated server-side against
the JSON schema bundled with the LiveSources service
(schemas/srt_settings.json). Field semantics:
mode—listener(UP listens for an incoming SRT connection) orcaller(UP dials out to a remote SRT server).- In listener mode,
whitelisted_ip_addressesis required andip/port(top-level and insideredundant_source) are ignored. - In caller mode, top-level
ipandportare required. - If
redundant_source.enabledistrueandmodeiscaller,redundant_source.ipandredundant_source.portare required. - If
aes_encryption.enabledistrue,key_lengthandpassphraseare required. When the source is also redundant,backup_key_lengthandbackup_passphraseare required as well.
The REST gateway exposes these settings as a structured
object using the snake_case names below; the upstream
GraphQL service stores the same data as a JSON-serialised
string with camelCase keys (e.g. whitelistedIpAddresses).
The gateway translates names in both directions.
Response
Update Source
SRT-specific source representation. Extends Source.
This is the GUID for the Source.
"e3c908ad-dc8f-4edb-88f7-c84dec0aef99"
SRT "SRT"
Source name
"CNN East Feed"
Describes the Source purpose
"Primary east-coast feed for breaking news."
INACTIVE, PENDING, ACTIVE, STOPPING, ERROR "ACTIVE"
PRIMARY, SECONDARY, UNKNOWN CONNECTED, DISCONNECTED, WAITING CONNECTED, DISCONNECTED, WAITING Whether two SRT receivers are deployed for redundancy.
SRT receiver configuration. Validated server-side against
the JSON schema bundled with the LiveSources service
(schemas/srt_settings.json). Field semantics:
mode—listener(UP listens for an incoming SRT connection) orcaller(UP dials out to a remote SRT server).- In listener mode,
whitelisted_ip_addressesis required andip/port(top-level and insideredundant_source) are ignored. - In caller mode, top-level
ipandportare required. - If
redundant_source.enabledistrueandmodeiscaller,redundant_source.ipandredundant_source.portare required. - If
aes_encryption.enabledistrue,key_lengthandpassphraseare required. When the source is also redundant,backup_key_lengthandbackup_passphraseare required as well.
The REST gateway exposes these settings as a structured
object using the snake_case names below; the upstream
GraphQL service stores the same data as a JSON-serialised
string with camelCase keys (e.g. whitelistedIpAddresses).
The gateway translates names in both directions.
Timestamp when the Source was last activated, in UTC iso8601 format.
"2025-04-21T15:53:12.388317Z"
Engine version that hosts the source.
Optional SRT passthrough URL when the source has passthrough enabled.
Ingress URL the customer's encoder pushes the primary stream to (caller mode), or that LiveCapture listens on (listener mode).
Cloud region in which the source is hosted.
Ingress URL for the redundant receiver, when redundancy is enabled.
Engine-reported metadata of the active stream as a JSON string.
Engine-reported SRT transport statistics for the primary receiver as a JSON string.
Engine-reported SRT transport statistics for the secondary receiver as a JSON string.
Timestamp when Source was created, in UTC iso8601 format.
"2025-04-21T15:53:12.388317Z"
Timestamp when Source was last updated, in UTC iso8601 format.
"2025-04-22T15:53:12.182617Z"
