---
title: "POST /getDataEndpoint"
method: POST
path: "/getDataEndpoint"
---

# POST /getDataEndpoint

`POST /getDataEndpoint`

Gets an endpoint for a specified stream for either reading or writing. Use this endpoint in your application to read from the specified stream (using the `GetMedia` or `GetMediaForFragmentList` operations) or write to it (using the `PutMedia` operation).

The returned endpoint does not have the API name appended. The client needs to add the API name to the returned endpoint.

In the request, specify the stream either by `StreamName` or `StreamARN`.

## Request body

- object
  - `StreamName` string — The name of the stream that you want to get the endpoint for. You must specify either this parameter or a <code>StreamARN</code> in the request.
  - `StreamARN` string — The Amazon Resource Name (ARN) of the stream that you want to get the endpoint for. You must specify either this parameter or a <code>StreamName</code> in the request.
  - `APIName` 'PUT_MEDIA' | 'GET_MEDIA' | 'LIST_FRAGMENTS' | 'GET_MEDIA_FOR_FRAGMENT_LIST' | 'GET_HLS_STREAMING_SESSION_URL' | 'GET_DASH_STREAMING_SESSION_URL' | 'GET_CLIP' | 'GET_IMAGES', required — The name of the API action for which to get an endpoint.

## Response `200`

Success

- GetDataEndpointOutput
  - `DataEndpoint` string — The endpoint value. To read data from the stream or to write data to it, specify this endpoint in your application.

## Other responses

- `480` — InvalidArgumentException
- `481` — ResourceNotFoundException
- `482` — ClientLimitExceededException
- `483` — NotAuthorizedException

---

[API](https://skmtc.net/aws/apis/kinesisvideo.md) · [All operations](https://skmtc.net/aws/apis/kinesisvideo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/kinesisvideo/versions/95357891934e/schema)