POST

/origin_endpoints

http://mediapackage.{region}.amazonaws.com/origin_endpoints

Creates a new OriginEndpoint record.

Access Token Required: API Key

Body Params

idstringrequired

The ID of the OriginEndpoint. The ID must be unique within the region and it cannot be changed after the OriginEndpoint is created.

tagsobject

A collection of tags associated with a resource

channelIdstringrequired

The ID of the Channel that the OriginEndpoint will be associated with. This cannot be changed after the OriginEndpoint is created.

whitelistarray

A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.

hlsPackageobject

An HTTP Live Streaming (HLS) packaging configuration.

mssPackageobject

A Microsoft Smooth Streaming (MSS) packaging configuration.

cmafPackageobject

A Common Media Application Format (CMAF) packaging configuration.

dashPackageobject

A Dynamic Adaptive Streaming over HTTP (DASH) packaging configuration.

descriptionstring

A short text description of the OriginEndpoint.

originationstring

Control whether origination of video is allowed for this OriginEndpoint. If set to ALLOW, the OriginEndpoint may by requested, pursuant to any other form of access control. If set to DENY, the OriginEndpoint may not be requested. This can be helpful for Live to VOD harvesting, or for temporarily disabling origination

manifestNamestring

A short string that will be used as the filename of the OriginEndpoint URL (defaults to "index").

authorizationobject

CDN Authorization credentials

timeDelaySecondsinteger

Amount of delay (seconds) to enforce on the playback of live content. If not specified, there will be no time delay in effect for the OriginEndpoint.

startoverWindowSecondsinteger

Maximum duration (seconds) of content to retain for startover playback. If not specified, startover playback will be disabled for the OriginEndpoint.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://mediapackage.{region}.amazonaws.com/origin_endpoints' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}