# AWS Elemental MediaTailor API Reference

> Use the AWS Elemental MediaTailor SDKs and CLI to configure scalable ad insertion and linear channels. With MediaTailor, you can assemble existing content into a linear stream and serve targeted ads to viewers while maintaining broadcast quality in over-the-top (OTT) video applications. For information about using the service, including detailed information about the settings covered in this guide, see the AWS Elemental MediaTailor User Guide.

- [Welcome](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.md)
- [Common Parameters](https://docs.aws.amazon.com/mediatailor/latest/apireference/CommonParameters.md)
- [Common Error Types](https://docs.aws.amazon.com/mediatailor/latest/apireference/CommonErrors.md)

## [Actions](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_Operations.md)

- [ConfigureLogsForChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ConfigureLogsForChannel.md): Configures Amazon CloudWatch log settings for a channel.
- [ConfigureLogsForPlaybackConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ConfigureLogsForPlaybackConfiguration.md): Defines where AWS Elemental MediaTailor sends logs for the playback configuration.
- [CreateChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreateChannel.md): Creates a channel.
- [CreateLiveSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreateLiveSource.md): The live source configuration.
- [CreatePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreatePrefetchSchedule.md): Creates a prefetch schedule for a playback configuration.
- [CreateProgram](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreateProgram.md): Creates a program within a channel.
- [CreateSourceLocation](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreateSourceLocation.md): Creates a source location.
- [CreateVodSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreateVodSource.md): The VOD source configuration parameters.
- [DeleteChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeleteChannel.md): Deletes a channel.
- [DeleteChannelPolicy](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeleteChannelPolicy.md): The channel policy to delete.
- [DeleteFunction](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeleteFunction.md): Deletes a function.
- [DeleteLiveSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeleteLiveSource.md): The live source to delete.
- [DeletePlaybackConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeletePlaybackConfiguration.md): Deletes a playback configuration.
- [DeletePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeletePrefetchSchedule.md): Deletes a prefetch schedule for a specific playback configuration.
- [DeleteProgram](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeleteProgram.md): Deletes a program within a channel.
- [DeleteSourceLocation](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeleteSourceLocation.md): Deletes a source location.
- [DeleteVodSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeleteVodSource.md): The video on demand (VOD) source to delete.
- [DescribeChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeChannel.md): Describes a channel.
- [DescribeLiveSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeLiveSource.md): The live source to describe.
- [DescribeProgram](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeProgram.md): Describes a program within a channel.
- [DescribeSourceLocation](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeSourceLocation.md): Describes a source location.
- [DescribeVodSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeVodSource.md): Provides details about a specific video on demand (VOD) source in a specific source location.
- [GetChannelPolicy](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_GetChannelPolicy.md): Returns the channel's IAM policy.
- [GetChannelSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_GetChannelSchedule.md): Retrieves information about your channel's schedule.
- [GetFunction](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_GetFunction.md): Retrieves the configuration and metadata for a function.
- [GetPlaybackConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_GetPlaybackConfiguration.md): Retrieves a playback configuration.
- [GetPrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_GetPrefetchSchedule.md): Retrieves a prefetch schedule for a playback configuration.
- [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.md): Lists the alerts that are associated with a MediaTailor channel assembly resource.
- [ListChannels](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListChannels.md): Retrieves information about the channels that are associated with the current AWS account.
- [ListFunctions](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListFunctions.md): Retrieves all functions associated with your AWS account in the current Region.
- [ListLiveSources](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListLiveSources.md): Lists the live sources contained in a source location.
- [ListPlaybackConfigurations](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListPlaybackConfigurations.md): Retrieves existing playback configurations.
- [ListPrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListPrefetchSchedules.md): Lists the prefetch schedules for a playback configuration.
- [ListSourceLocations](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListSourceLocations.md): Lists the source locations for a channel.
- [ListTagsForResource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListTagsForResource.md): A list of tags that are associated with this resource.
- [ListVodSources](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListVodSources.md): Lists the VOD sources contained in a source location.
- [PutChannelPolicy](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutChannelPolicy.md): Creates an IAM policy for the channel.
- [PutFunction](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutFunction.md): Creates or updates a function.
- [PutPlaybackConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.md): Creates a playback configuration.
- [StartChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_StartChannel.md): Starts a channel.
- [StopChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_StopChannel.md): Stops a channel.
- [TagResource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_TagResource.md): The resource to tag.
- [UntagResource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UntagResource.md): The resource to untag.
- [UpdateChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UpdateChannel.md): Updates a channel.
- [UpdateLiveSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UpdateLiveSource.md): Updates a live source's configuration.
- [UpdateProgram](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UpdateProgram.md): Updates a program within a channel.
- [UpdateSourceLocation](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UpdateSourceLocation.md): Updates a source location.
- [UpdateVodSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UpdateVodSource.md): Updates a VOD source's configuration.


## [Data Types](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_Types.md)

- [AccessConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AccessConfiguration.md): Access configuration parameters.
- [AdBreak](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdBreak.md): Ad break configuration parameters.
- [AdBreakOpportunity](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdBreakOpportunity.md): A location at which a zero-duration ad marker was detected in a VOD source manifest.
- [AdConditioningConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdConditioningConfiguration.md): The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.
- [AdDecisionServerConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdDecisionServerConfiguration.md): Configuration parameters for customizing HTTP requests sent to the ad decision server (ADS).
- [AdMarkerPassthrough](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdMarkerPassthrough.md): For HLS, when set to true, MediaTailor passes through EXT-X-CUE-IN, EXT-X-CUE-OUT, and EXT-X-SPLICEPOINT-SCTE35 ad markers from the origin manifest to the MediaTailor personalized manifest.
- [AdsInteractionLog](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdsInteractionLog.md): Settings for customizing what events are included in logs for interactions with the ad decision server (ADS).
- [AdsPersonalizationConcurrency](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdsPersonalizationConcurrency.md): The concurrency settings for ad decision server interactions during ad personalization.
- [AdsPersonalizationTimeouts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AdsPersonalizationTimeouts.md): The timeout settings for ad decision server interactions during ad personalization.
- [Alert](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_Alert.md): Alert configuration parameters.
- [AlternateMedia](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AlternateMedia.md): A playlist of media (VOD and/or live) to be played instead of the default media on a particular program.
- [AudienceMedia](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AudienceMedia.md): An AudienceMedia object contains an Audience and a list of AlternateMedia.
- [AvailMatchingCriteria](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AvailMatchingCriteria.md): MediaTailor only places (consumes) prefetched ads if the ad break meets the criteria defined by the dynamic variables.
- [AvailSuppression](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_AvailSuppression.md): The configuration for avail suppression, also known as ad suppression.
- [Bumper](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_Bumper.md): The configuration for bumpers.
- [CdnConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CdnConfiguration.md): The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.
- [Channel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_Channel.md): The configuration parameters for a channel.
- [ClipRange](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ClipRange.md): Clip range configuration for the VOD source associated with the program.
- [ConcurrentExecutorConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ConcurrentExecutorConfiguration.md): The configuration for a CONCURRENT_EXECUTOR function.
- [CustomOutputConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CustomOutputConfiguration.md): The configuration for a CUSTOM_OUTPUT function.
- [DashConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DashConfiguration.md): The configuration for DASH content.
- [DashConfigurationForPut](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DashConfigurationForPut.md): The configuration for DASH PUT operations.
- [DashPlaylistSettings](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DashPlaylistSettings.md): Dash manifest configuration parameters.
- [DefaultSegmentDeliveryConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DefaultSegmentDeliveryConfiguration.md): The optional configuration for a server that serves segments.
- [Function](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_Function.md): Defines reusable logic that MediaTailor executes at lifecycle hooks during ad insertion.
- [FunctionRef](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_FunctionRef.md): A reference to a child function within a SEQUENTIAL_EXECUTOR function.
- [HlsConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_HlsConfiguration.md): The configuration for HLS content.
- [HlsPlaylistSettings](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_HlsPlaylistSettings.md): HLS playlist configuration parameters.
- [HttpConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_HttpConfiguration.md): The HTTP configuration for the source location.
- [HttpPackageConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_HttpPackageConfiguration.md): The HTTP package configuration properties for the requested VOD source.
- [HttpRequest](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_HttpRequest.md): HTTP request configuration parameters that define how MediaTailor communicates with the ad decision server.
- [HttpRequestConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_HttpRequestConfiguration.md): The configuration for an HTTP_REQUEST function.
- [KeyValuePair](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_KeyValuePair.md): For SCTE35_ENHANCED output, defines a key and corresponding value.
- [LivePreRollConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_LivePreRollConfiguration.md): The configuration for pre-roll ad insertion.
- [LiveSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_LiveSource.md): Live source configuration parameters.
- [LogConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_LogConfiguration.md): Defines where AWS Elemental MediaTailor sends logs for the playback configuration.
- [LogConfigurationForChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_LogConfigurationForChannel.md): The log configuration for the channel.
- [ManifestProcessingRules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ManifestProcessingRules.md): The configuration for manifest processing rules.
- [ManifestServiceInteractionLog](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ManifestServiceInteractionLog.md): Settings for customizing what events are included in logs for interactions with the origin server.
- [PlaybackConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PlaybackConfiguration.md): A playback configuration.
- [PrefetchConsumption](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchConsumption.md): For single prefetch, describes how and when that MediaTailor places prefetched ads into upcoming ad breaks.
- [PrefetchRetrieval](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchRetrieval.md): A complex type that contains settings governing when MediaTailor prefetches ads, and which dynamic variables that MediaTailor includes in the request to the ad decision server.
- [PrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.md): A prefetch schedule allows you to tell MediaTailor to fetch and prepare certain ads before an ad break happens.
- [PreRollAdDecisionServerConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PreRollAdDecisionServerConfiguration.md): The ad decision server configuration for live pre-roll ads.
- [PreRollVastResponse](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PreRollVastResponse.md): The settings that control how MediaTailor processes VAST responses from the ad decision server for live pre-roll ad breaks.
- [RecurringConsumption](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_RecurringConsumption.md): The settings that determine how and when MediaTailor places prefetched ads into upcoming ad breaks for recurring prefetch scedules.
- [RecurringPrefetchConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_RecurringPrefetchConfiguration.md): The configuration that defines how MediaTailor performs recurring prefetch.
- [RecurringRetrieval](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_RecurringRetrieval.md): With recurring prefetch, MediaTailor automatically prefetches ads for every avail that occurs during the retrieval window.
- [RequestOutputItem](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_RequestOutputItem.md): The output configuration for this channel.
- [ResponseOutputItem](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ResponseOutputItem.md): The output item response.
- [ScheduleAdBreak](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ScheduleAdBreak.md): The schedule's ad break properties.
- [ScheduleConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ScheduleConfiguration.md): Schedule configuration parameters.
- [ScheduleEntry](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ScheduleEntry.md): The properties for a schedule.
- [SecretsManagerAccessTokenConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_SecretsManagerAccessTokenConfiguration.md): AWS Secrets Manager access token configuration parameters.
- [SegmentationDescriptor](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_SegmentationDescriptor.md): The segmentation_descriptor message can contain advanced metadata fields, like content identifiers, to convey a wide range of information about the ad break.
- [SegmentDeliveryConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_SegmentDeliveryConfiguration.md): The segment delivery configuration settings.
- [SequentialExecutorConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_SequentialExecutorConfiguration.md): The configuration for a SEQUENTIAL_EXECUTOR function.
- [SlateSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_SlateSource.md): Slate VOD source configuration.
- [SourceLocation](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_SourceLocation.md): A source location is a container for sources.
- [SpliceInsertMessage](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_SpliceInsertMessage.md): Splice insert message configuration.
- [TimeShiftConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_TimeShiftConfiguration.md): The configuration for time-shifted viewing.
- [TimeSignalMessage](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_TimeSignalMessage.md): The SCTE-35 time_signal message can be sent with one or more segmentation_descriptor messages.
- [TrafficShapingRetrievalWindow](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_TrafficShapingRetrievalWindow.md): The configuration that tells AWS Elemental MediaTailor how many seconds to spread out requests to the ad decision server (ADS).
- [TrafficShapingTpsConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_TrafficShapingTpsConfiguration.md): The configuration for TPS-based traffic shaping.
- [Transition](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_Transition.md): Program transition configuration.
- [UpdateProgramScheduleConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UpdateProgramScheduleConfiguration.md): Schedule configuration parameters.
- [UpdateProgramTransition](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_UpdateProgramTransition.md): Program transition configuration.
- [VastResponse](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_VastResponse.md): The settings that control how MediaTailor processes VAST responses from the ad decision server.
- [VodSource](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_VodSource.md): VOD source configuration parameters.


## Full content

The entire guide is also available as a single markdown file, useful for feeding the full guide to an LLM in one pass:

- [Complete guide (single file)](https://docs.aws.amazon.com/mediatailor/latest/apireference/full.md)