Amazon MediaLive Medialive Programs API
The Medialive Programs API from Amazon MediaLive — 2 operation(s) for medialive programs.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-medialive:amazon-medialive-programs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: AWS Elemental MediaLive Programs API
version: '2017-10-14'
description: Generated from AWS's published Smithy model for AWS Elemental MediaLive. 5 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://medialive.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Programs
paths:
/prod/multiplexes/{MultiplexId}/programs:
post:
operationId: CreateMultiplexProgram
summary: Create Multiplex Program
description: Create a new program in the multiplex.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateMultiplexProgramResponse'
'502':
description: BadGatewayException
content:
application/json:
schema:
$ref: '#/components/schemas/BadGatewayException'
'400':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'403':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
'504':
description: GatewayTimeoutException
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutException'
'500':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
'429':
description: TooManyRequestsException
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequestsException'
'422':
description: UnprocessableEntityException
content:
application/json:
schema:
$ref: '#/components/schemas/UnprocessableEntityException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateMultiplexProgramRequest'
tags:
- Programs
get:
operationId: ListMultiplexPrograms
summary: List Multiplex Programs
description: List the programs that currently exist for a specific multiplex.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListMultiplexProgramsResponse'
'502':
description: BadGatewayException
content:
application/json:
schema:
$ref: '#/components/schemas/BadGatewayException'
'400':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
'403':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
'504':
description: GatewayTimeoutException
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutException'
'500':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
'404':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
'429':
description: TooManyRequestsException
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequestsException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListMultiplexProgramsRequest'
tags:
- Programs
/prod/multiplexes/{MultiplexId}/programs/{ProgramName}:
delete:
operationId: DeleteMultiplexProgram
summary: Delete Multiplex Program
description: Delete a program from a multiplex.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteMultiplexProgramResponse'
'502':
description: BadGatewayException
content:
application/json:
schema:
$ref: '#/components/schemas/BadGatewayException'
'400':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'403':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
'504':
description: GatewayTimeoutException
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutException'
'500':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
'404':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
'429':
description: TooManyRequestsException
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequestsException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteMultiplexProgramRequest'
tags:
- Programs
get:
operationId: DescribeMultiplexProgram
summary: Describe Multiplex Program
description: Get the details for a program in a multiplex.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeMultiplexProgramResponse'
'502':
description: BadGatewayException
content:
application/json:
schema:
$ref: '#/components/schemas/BadGatewayException'
'400':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
'403':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
'504':
description: GatewayTimeoutException
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutException'
'500':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
'404':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
'429':
description: TooManyRequestsException
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequestsException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeMultiplexProgramRequest'
tags:
- Programs
put:
operationId: UpdateMultiplexProgram
summary: Update Multiplex Program
description: Update a program in a multiplex.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateMultiplexProgramResponse'
'502':
description: BadGatewayException
content:
application/json:
schema:
$ref: '#/components/schemas/BadGatewayException'
'400':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'403':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
'504':
description: GatewayTimeoutException
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutException'
'500':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
'404':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
'422':
description: UnprocessableEntityException
content:
application/json:
schema:
$ref: '#/components/schemas/UnprocessableEntityException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateMultiplexProgramRequest'
tags:
- Programs
components:
schemas:
MultiplexStatmuxVideoSettings:
type: object
properties:
MaximumBitrate:
type: integer
description: Maximum statmux bitrate.
MinimumBitrate:
type: integer
description: Minimum statmux bitrate.
Priority:
type: integer
description: The purpose of the priority is to use a combination of the\nmultiplex rate control algorithm and the QVBR capability of the\nencoder to prioritize the video quality of some channels in a\nmultiplex over others. Channels that have a higher priority will\nget higher video quality at the expense of the video quality of\nother channels in the multiplex with lower priority.
DescribeMultiplexProgramRequest:
type: object
properties:
MultiplexId:
type: string
description: The ID of the multiplex that the program belongs to.
ProgramName:
type: string
description: The name of the program.
required:
- MultiplexId
- ProgramName
MultiplexProgramPacketIdentifiersMap:
type: object
properties:
AudioPids:
type: array
items:
type: integer
DvbSubPids:
type: array
items:
type: integer
DvbTeletextPid:
type: integer
EtvPlatformPid:
type: integer
EtvSignalPid:
type: integer
KlvDataPids:
type: array
items:
type: integer
PcrPid:
type: integer
PmtPid:
type: integer
PrivateMetadataPid:
type: integer
Scte27Pids:
type: array
items:
type: integer
Scte35Pid:
type: integer
TimedMetadataPid:
type: integer
VideoPid:
type: integer
AribCaptionsPid:
type: integer
DvbTeletextPids:
type: array
items:
type: integer
EcmPid:
type: integer
Smpte2038Pid:
type: integer
UpdateMultiplexProgramRequest:
type: object
properties:
MultiplexId:
type: string
description: The ID of the multiplex of the program to update.
MultiplexProgramSettings:
$ref: '#/components/schemas/MultiplexProgramSettings'
ProgramName:
type: string
description: The name of the program to update.
required:
- MultiplexId
- ProgramName
DescribeMultiplexProgramResponse:
type: object
properties:
ChannelId:
type: string
description: The MediaLive channel associated with the program.
MultiplexProgramSettings:
$ref: '#/components/schemas/MultiplexProgramSettings'
PacketIdentifiersMap:
$ref: '#/components/schemas/MultiplexProgramPacketIdentifiersMap'
PipelineDetails:
type: array
items:
$ref: '#/components/schemas/MultiplexProgramPipelineDetail'
description: Contains information about the current sources for the specified program in the specified multiplex. Keep in mind that each multiplex pipeline connects to both pipelines in a given source channel (the channel identified by the program). But only one of those channel pipelines is ever active at one time.
ProgramName:
type: string
description: The name of the multiplex program.
CreateMultiplexProgramResponse:
type: object
properties:
MultiplexProgram:
$ref: '#/components/schemas/MultiplexProgram'
TooManyRequestsException:
type: object
properties:
Message:
type: string
MultiplexVideoSettings:
type: object
properties:
ConstantBitrate:
type: integer
description: The constant bitrate configuration for the video encode. When this field is defined, StatmuxSettings must be undefined.
StatmuxSettings:
$ref: '#/components/schemas/MultiplexStatmuxVideoSettings'
NotFoundException:
type: object
properties:
Message:
type: string
ForbiddenException:
type: object
properties:
Message:
type: string
ValidationError:
type: object
properties:
ElementPath:
type: string
description: Path to the source of the error.
ErrorMessage:
type: string
description: The error message.
GatewayTimeoutException:
type: object
properties:
Message:
type: string
BadRequestException:
type: object
properties:
Message:
type: string
InternalServerErrorException:
type: object
properties:
Message:
type: string
MultiplexProgramServiceDescriptor:
type: object
properties:
ProviderName:
type: string
description: Name of the provider.
ServiceName:
type: string
description: Name of the service.
required:
- ProviderName
- ServiceName
BadGatewayException:
type: object
properties:
Message:
type: string
MultiplexProgramSummary:
type: object
properties:
ChannelId:
type: string
description: The MediaLive Channel associated with the program.
ProgramName:
type: string
description: The name of the multiplex program.
ListMultiplexProgramsRequest:
type: object
properties:
MaxResults:
type: integer
description: The maximum number of items to return.
MultiplexId:
type: string
description: The ID of the multiplex that the programs belong to.
NextToken:
type: string
description: The token to retrieve the next page of results.
required:
- MultiplexId
CreateMultiplexProgramRequest:
type: object
properties:
MultiplexId:
type: string
description: ID of the multiplex where the program is to be created.
MultiplexProgramSettings:
$ref: '#/components/schemas/MultiplexProgramSettings'
ProgramName:
type: string
description: Name of multiplex program.
RequestId:
type: string
description: Unique request ID. This prevents retries from creating multiple resources.
required:
- MultiplexId
- MultiplexProgramSettings
- ProgramName
- RequestId
DeleteMultiplexProgramRequest:
type: object
properties:
MultiplexId:
type: string
description: The ID of the multiplex that the program belongs to.
ProgramName:
type: string
description: The multiplex program name.
required:
- MultiplexId
- ProgramName
ListMultiplexProgramsResponse:
type: object
properties:
MultiplexPrograms:
type: array
items:
$ref: '#/components/schemas/MultiplexProgramSummary'
description: List of multiplex programs.
NextToken:
type: string
description: Token for the next ListMultiplexProgram request.
DeleteMultiplexProgramResponse:
type: object
properties:
ChannelId:
type: string
description: The MediaLive channel associated with the program.
MultiplexProgramSettings:
$ref: '#/components/schemas/MultiplexProgramSettings'
PacketIdentifiersMap:
$ref: '#/components/schemas/MultiplexProgramPacketIdentifiersMap'
PipelineDetails:
type: array
items:
$ref: '#/components/schemas/MultiplexProgramPipelineDetail'
description: Contains information about the current sources for the specified program in the specified multiplex. Keep in mind that each multiplex pipeline connects to both pipelines in a given source channel (the channel identified by the program). But only one of those channel pipelines is ever active at one time.
ProgramName:
type: string
description: The name of the multiplex program.
MultiplexProgram:
type: object
properties:
ChannelId:
type: string
description: The MediaLive channel associated with the program.
MultiplexProgramSettings:
$ref: '#/components/schemas/MultiplexProgramSettings'
PacketIdentifiersMap:
$ref: '#/components/schemas/MultiplexProgramPacketIdentifiersMap'
PipelineDetails:
type: array
items:
$ref: '#/components/schemas/MultiplexProgramPipelineDetail'
description: Contains information about the current sources for the specified program in the specified multiplex. Keep in mind that each multiplex pipeline connects to both pipelines in a given source channel (the channel identified by the program). But only one of those channel pipelines is ever active at one time.
ProgramName:
type: string
description: The name of the multiplex program.
UnprocessableEntityException:
type: object
properties:
Message:
type: string
description: The error message.
ValidationErrors:
type: array
items:
$ref: '#/components/schemas/ValidationError'
description: A collection of validation error responses.
ConflictException:
type: object
properties:
Message:
type: string
MultiplexProgramSettings:
type: object
properties:
PreferredChannelPipeline:
type: string
enum:
- CURRENTLY_ACTIVE
- PIPELINE_0
- PIPELINE_1
description: Indicates which pipeline is preferred by the multiplex for program ingest.
ProgramNumber:
type: integer
description: Unique program number.
ServiceDescriptor:
$ref: '#/components/schemas/MultiplexProgramServiceDescriptor'
VideoSettings:
$ref: '#/components/schemas/MultiplexVideoSettings'
required:
- ProgramNumber
UpdateMultiplexProgramResponse:
type: object
properties:
MultiplexProgram:
$ref: '#/components/schemas/MultiplexProgram'
MultiplexProgramPipelineDetail:
type: object
properties:
ActiveChannelPipeline:
type: string
description: Identifies the channel pipeline that is currently active for the pipeline (identified by PipelineId) in the multiplex.
PipelineId:
type: string
description: Identifies a specific pipeline in the multiplex.
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: medialive
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/medialive/service/2017-10-14/medialive-2017-10-14.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)