# AWS Elemental MediaPackage v2 API

> AWS Elemental MediaPackage v2 API on Apizie: 24 endpoints (Retrieves all channels in a specific channel group that are configured in AWS Elemental MediaPackage,…, Create a channel to start receiving content streams. The channel represents the input to MediaPackage for…, Retrieves all channel groups that are configured in AWS Elemental MediaPackage, including the channels and…, Create a channel group to group your channels and origin endpoints. A channel group is the top-level…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-mediapackagev2`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-mediapackagev2
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-mediapackagev2/openapi.json

This guide is intended for creating AWS Elemental MediaPackage resources in MediaPackage Version 2 (v2) starting from May 2023. To get started with MediaPackage v2, create your MediaPackage resources. There isn't an…

## Endpoints

### Retrieves all channels in a specific channel group that are configured in AWS Elemental MediaPackage,…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/list-channels` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| maxResults | integer | no | The maximum number of results to return in the response. |
| nextToken | string | no | The pagination token from the GET list request. Use the token to fetch the next page of results. |
| MaxResults | string | no | Pagination limit |
| NextToken | string | no | Pagination token |

### Create a channel to start receiving content streams. The channel represents the input to MediaPackage for…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/create-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| x-amzn-client-token | string | no | A unique, case-sensitive token that you provide to ensure the idempotency of the request. |
| body | object | yes | JSON request body |

### Retrieves all channel groups that are configured in AWS Elemental MediaPackage, including the channels and…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/list-channel-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | The maximum number of results to return in the response. |
| nextToken | string | no | The pagination token from the GET list request. Use the token to fetch the next page of results. |
| MaxResults | string | no | Pagination limit |
| NextToken | string | no | Pagination token |

### Create a channel group to group your channels and origin endpoints. A channel group is the top-level…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/create-channel-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| x-amzn-client-token | string | no | A unique, case-sensitive token that you provide to ensure the idempotency of the request. |
| body | object | yes | JSON request body |

### Retrieves all origin endpoints in a specific channel that are configured in AWS Elemental MediaPackage.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/list-origin-endpoints` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| maxResults | integer | no | The maximum number of results to return in the response. |
| nextToken | string | no | The pagination token from the GET list request. Use the token to fetch the next page of results. |
| MaxResults | string | no | Pagination limit |
| NextToken | string | no | Pagination token |

### The endpoint is attached to a channel, and represents the output of the live content. You can associate…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/create-origin-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| x-amzn-client-token | string | no | A unique, case-sensitive token that you provide to ensure the idempotency of the request. |
| body | object | yes | JSON request body |

### Retrieves the specified channel that's configured in AWS Elemental MediaPackage, including the origin…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/get-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |

### Update the specified channel. You can edit if MediaPackage sends ingest or egress access logs to the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/update-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| body | object | yes | JSON request body |

### Delete a channel to stop AWS Elemental MediaPackage from receiving further content. You must delete the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/delete-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |

### Retrieves the specified channel group that's configured in AWS Elemental MediaPackage, including the…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/get-channel-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |

### Update the specified channel group. You can edit the description on a channel group for easier…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/update-channel-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| body | object | yes | JSON request body |

### Delete a channel group. You must delete the channel group's channels and origin endpoints before you can…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/delete-channel-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |

### Retrieves the specified channel policy that's configured in AWS Elemental MediaPackage. With policies, you…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/get-channel-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |

### Attaches an IAM policy to the specified channel. With policies, you can specify who has access to AWS…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/put-channel-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| body | object | yes | JSON request body |

### Delete a channel policy.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/delete-channel-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |

### Retrieves the specified origin endpoint that's configured in AWS Elemental MediaPackage to obtain its…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/get-origin-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| OriginEndpointName | string | yes | The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your… |

### Update the specified origin endpoint. Edit the packaging preferences on an endpoint to optimize the viewing…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/update-origin-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| OriginEndpointName | string | yes | The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your… |
| body | object | yes | JSON request body |

### Origin endpoints can serve content until they're deleted. Delete the endpoint if it should no longer respond…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/delete-origin-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| OriginEndpointName | string | yes | The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your… |

### Retrieves the specified origin endpoint policy that's configured in AWS Elemental MediaPackage.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/get-origin-endpoint-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| OriginEndpointName | string | yes | The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your… |

### Attaches an IAM policy to the specified origin endpoint. You can attach only one policy with each request.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/put-origin-endpoint-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| OriginEndpointName | string | yes | The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your… |
| body | object | yes | JSON request body |

### Delete an origin endpoint policy.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/delete-origin-endpoint-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ChannelGroupName | string | yes | The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account… |
| ChannelName | string | yes | The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS… |
| OriginEndpointName | string | yes | The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your… |

### Lists the tags assigned to a resource.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceArn | string | yes | The ARN of the CloudWatch resource that you want to view tags for. |

### Assigns one of more tags (key-value pairs) to the specified MediaPackage resource. Tags can help you…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceArn | string | yes | The ARN of the MediaPackage resource that you're adding tags to. |
| body | object | yes | JSON request body |

### Removes one or more tags from the specified resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceArn | string | yes | The ARN of the MediaPackage resource that you're removing tags from. |
| tagKeys | array | yes | The list of tag keys to remove from the resource. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/list-channels" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS Elemental MediaPackage v2 API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:amazonaws-mediapackagev2/list-channels with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS Elemental MediaPackage v2 API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS Elemental MediaPackage v2 itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS Elemental MediaPackage v2 API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-mediapackagev2.

### What is the status of the AWS Elemental MediaPackage v2 API?
Needs your own provider key (bring your own key)