How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amazon MediaConnect Flows API

The Flows API from Amazon MediaConnect — 14 operation(s) for flows.

Amazon MediaConnect Flows API is one of 8 APIs that Amazon MediaConnect publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Flows. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and pricing.

This API exposes 21 operations across 14 paths, and defines 103 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 4 base URLs: http://mediaconnect.{region}.amazonaws.com, https://mediaconnect.{region}.amazonaws.com, http://mediaconnect.{region}.amazonaws.com.cn, https://mediaconnect.{region}.amazonaws.com.cn.

21 operations 14 paths 103 schemas 6 DELETE2 GET8 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://mediaconnect.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Amazon MediaConnect Flows API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 21

Across 14 paths, the API surfaces 21 operations — 6 DELETE, 2 GET, 8 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Flows 21
POST
/v1/flows/{flowArn}/mediaStreams
Amazon MediaConnect Add Flow Media Streams
AddFlowMediaStreams 8 params body → 201480481482483484485
POST
/v1/flows/{flowArn}/outputs
Amazon MediaConnect Add Flow Outputs
AddFlowOutputs 8 params body → 201480481482483484485486
POST
/v1/flows/{flowArn}/source
Amazon MediaConnect Add Flow Sources
AddFlowSources 8 params body → 201480481482483484485
POST
/v1/flows/{flowArn}/vpcInterfaces
Amazon MediaConnect Add Flow Vpc Interfaces
AddFlowVpcInterfaces 8 params body → 201480481482483484485
POST
/v1/flows
Amazon MediaConnect Create Flow
CreateFlow 7 params body → 201480481482483484485
GET
/v1/flows
Amazon MediaConnect List Flows
ListFlows 11 params → 200480481482483
DELETE
/v1/flows/{flowArn}
Amazon MediaConnect Delete Flow
DeleteFlow 8 params → 202480481482483484485
GET
/v1/flows/{flowArn}
Amazon MediaConnect Describe Flow
DescribeFlow 8 params → 200480481482483484485
PUT
/v1/flows/{flowArn}
Amazon MediaConnect Update Flow
UpdateFlow 8 params body → 202480481482483484485
POST
/v1/flows/{flowArn}/entitlements
Amazon MediaConnect Grant Flow Entitlements
GrantFlowEntitlements 8 params body → 200480481482483484485486
DELETE
/v1/flows/{flowArn}/mediaStreams/{mediaStreamName}
Amazon MediaConnect Remove Flow Media Stream
RemoveFlowMediaStream 9 params → 200480481482483484485
PUT
/v1/flows/{flowArn}/mediaStreams/{mediaStreamName}
Amazon MediaConnect Update Flow Media Stream
UpdateFlowMediaStream 9 params body → 202480481482483484485
DELETE
/v1/flows/{flowArn}/outputs/{outputArn}
Amazon MediaConnect Remove Flow Output
RemoveFlowOutput 9 params → 202480481482483484485
PUT
/v1/flows/{flowArn}/outputs/{outputArn}
Amazon MediaConnect Update Flow Output
UpdateFlowOutput 9 params body → 202480481482483484485
DELETE
/v1/flows/{flowArn}/source/{sourceArn}
Amazon MediaConnect Remove Flow Source
RemoveFlowSource 9 params → 202480481482483484485
PUT
/v1/flows/{flowArn}/source/{sourceArn}
Amazon MediaConnect Update Flow Source
UpdateFlowSource 9 params body → 202480481482483484485
DELETE
/v1/flows/{flowArn}/vpcInterfaces/{vpcInterfaceName}
Amazon MediaConnect Remove Flow Vpc Interface
RemoveFlowVpcInterface 9 params → 200480481482483484485
DELETE
/v1/flows/{flowArn}/entitlements/{entitlementArn}
Amazon MediaConnect Revoke Flow Entitlement
RevokeFlowEntitlement 9 params → 202480481482483484485
PUT
/v1/flows/{flowArn}/entitlements/{entitlementArn}
Amazon MediaConnect Update Flow Entitlement
UpdateFlowEntitlement 9 params body → 202480481482483484485
POST
/v1/flows/start/{flowArn}
Amazon MediaConnect Start Flow
StartFlow 8 params → 202480481482483484485
POST
/v1/flows/stop/{flowArn}
Amazon MediaConnect Stop Flow
StopFlow 8 params → 202480481482483484485

Schemas 103

The contract defines 103 schemas that model the data the API accepts and returns. The most detailed are SetSourceRequest (19 properties), Source (15 properties), AddOutputRequest (15 properties), Output (15 properties). Each schema is shown below with its type and property counts.

UpdateFlowSourceResponse
object
2 properties
ScanMode
string
__listOf__integer
array
__listOfListedFlow
array
RemoveFlowVpcInterfaceResponse
object
3 properties
UpdateFlowEntitlementResponse
object
2 properties
MediaStreamOutputConfiguration
object
The media stream that is associated with the output, and the parameters for that association.
4 properties 2 required
ForbiddenException
UpdateFlowMediaStreamResponse
object
2 properties
__listOfDestinationConfiguration
array
RevokeFlowEntitlementResponse
object
2 properties
__listOfOutput
array
VpcInterface
object
The settings for a VPC Source.
6 properties 6 required
__listOfEntitlement
array
InputConfiguration
object
The transport parameters that are associated with an incoming media stream.
3 properties 3 required
EncodingParametersRequest
object
A collection of parameters that determine how MediaConnect will convert the content. These fields only apply to outputs on flows that have a CDI source.
2 properties 2 required
Maintenance
object
The maintenance setting of a flow
4 properties
Messages
object
Messages that provide the state of the flow.
1 property 1 required
MediaStreamType
string
MediaStreamSourceConfigurationRequest
object
The definition of a media stream that you want to associate with the source.
3 properties 2 required
Tcs
string
InternalServerErrorException
FailoverConfig
object
The settings for source failover.
4 properties
CreateFlow420Exception
AddFlowMediaStreamsResponse
object
2 properties
__listOfSource
array
MediaStreamSourceConfiguration
object
The media stream that is associated with the source, and the parameters for that association.
3 properties 2 required
Interface
object
The VPC interface that is used for the media stream associated with the source or output.
1 property 1 required
Algorithm
string
TooManyRequestsException
AddFlowOutputsResponse
object
2 properties
VpcInterfaceAttachment
object
The settings for attaching a VPC interface to an resource.
1 property
EncoderProfile
string
__listOfInputConfigurationRequest
array
AddFlowOutputs420Exception
__listOfVpcInterface
array
RemoveFlowSourceResponse
object
2 properties
MediaStreamAttributesRequest
object
Attributes that are related to the media stream.
2 properties
FmtpRequest
object
The settings that you want to use to define the media stream.
7 properties
__listOfMediaStreamOutputConfiguration
array
__string
string
__integer
integer
__listOfInputConfiguration
array
State
string
__listOfMediaStream
array
KeyType
string
GrantEntitlementRequest
object
The entitlements that you want to grant on a flow.
6 properties 1 required
EncodingParameters
object
A collection of parameters that determine how MediaConnect will convert the content. These fields only apply to outputs on flows that have a CDI source.
2 properties 2 required
VpcInterfaceRequest
object
Desired VPC Interface for a Flow
5 properties 4 required
SetSourceRequest
object
The settings for the source of the flow.
19 properties
EncodingName
string
Colorimetry
string
MediaStreamOutputConfigurationRequest
object
The media stream that you want to associate with the output, and the parameters for that association.
4 properties 2 required
Range
string
__listOf__string
array
Entitlement
object
The settings for a flow entitlement.
7 properties 3 required
DestinationConfigurationRequest
object
The transport parameters that you want to associate with an outbound media stream.
3 properties 3 required
InterfaceRequest
object
The VPC interface that you want to designate where the media stream is coming from or going to.
1 property 1 required
SetGatewayBridgeSourceRequest
object
The source configuration for cloud flows receiving a stream from a bridge.
2 properties 1 required
__double
number
ListFlowsResponse
object
2 properties
GrantFlowEntitlementsResponse
object
2 properties
AddFlowVpcInterfacesResponse
object
2 properties
Source
object
The settings for the source of the flow.
15 properties 2 required
Fmtp
object
FMTP
7 properties
BadRequestException
ListedFlow
object
Provides a summary of a flow, including its ARN, Availability Zone, and source type.
7 properties 6 required
SourceType
string
CreateFlowResponse
object
1 property
EntitlementStatus
string
Flow
object
The settings for a flow, including its source, outputs, and entitlements.
14 properties 7 required
UpdateFlowOutputResponse
object
2 properties
NotFoundException
ServiceUnavailableException
NetworkInterfaceType
string
Protocol
string
DeleteFlowResponse
object
2 properties
AddMediaStreamRequest
object
The media stream that you want to add to the flow.
7 properties 3 required
__listOfMediaStreamSourceConfiguration
array
MediaStream
object
A single track or stream of media that contains video, audio, or ancillary data. After you add a media stream to a flow, you can associate it with sources and…
8 properties 4 required
MaintenanceDay
string
AddFlowSourcesResponse
object
2 properties
StopFlowResponse
object
2 properties
InputConfigurationRequest
object
The transport parameters that you want to associate with an incoming media stream.
2 properties 2 required
UpdateFlowResponse
object
1 property
Output
object
The settings for an output.
15 properties 2 required
AddOutputRequest
object
The output that you want to add to this flow.
15 properties 1 required
Transport
object
Attributes related to the transport stream that are used in a source or output.
13 properties 1 required
DestinationConfiguration
object
The transport parameters that are associated with an outbound media stream.
4 properties 4 required
RemoveFlowMediaStreamResponse
object
2 properties
__listOfDestinationConfigurationRequest
array
__listOfMediaStreamOutputConfigurationRequest
array
MediaStreamAttributes
object
Attributes that are related to the media stream.
2 properties 1 required
__listOfMediaStreamSourceConfigurationRequest
array
Encryption
object
Information about the encryption of the flow.
9 properties 1 required
DescribeFlowResponse
object
2 properties
SourcePriority
object
The priority you want to assign to a source. You can have a primary stream and a backup stream or two equally prioritized streams.
1 property
RemoveFlowOutputResponse
object
2 properties
FailoverMode
string
Status
string
GatewayBridgeSource
object
The source configuration for cloud flows receiving a stream from a bridge.
2 properties 1 required
StartFlowResponse
object
2 properties
GrantFlowEntitlements420Exception

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amazon-mediaconnect-flows-api-openapi.yml Raw ↑

Other APIs Amazon MediaConnect publishes across the network.

Amazon MediaConnect Bridges API
Amazon MediaConnect Entitlements API
Amazon MediaConnect Gateway Instances API
Amazon MediaConnect Gateways API
Amazon MediaConnect Offerings API
Amazon MediaConnect Reservations API
Amazon MediaConnect Tags API
Where this information came from

This is an independent, third-party profile of Amazon MediaConnect Flows API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.