POST

/2017-08-29/endpoints

http://mediaconvert.{region}.amazonaws.com/2017-08-29/endpoints

Send an request with an empty body to the regional API endpoint to get your account API endpoint.

Access Token Required: API Key

Query Params

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Body Params

modestring

Optional field, defaults to DEFAULT. Specify DEFAULT for this operation to return your endpoints if any exist, or to create an endpoint for you and return it if one doesn't already exist. Specify GET_ONLY to return your endpoints if any exist, or an empty list if none exist.

nextTokenstring

Use this string, provided with the response to a previous request, to request the next batch of endpoints.

maxResultsinteger

Optional. Max number of endpoints, up to twenty, that will be returned at one time.

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://mediaconvert.{region}.amazonaws.com/2017-08-29/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}