com.bandwidth.sdk.api.MediaApi Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of bandwidth-sdk Show documentation
The official client SDK for Bandwidth's Voice, Messaging, MFA, and WebRTC APIs
The newest version!
/*
 * Bandwidth
 * Bandwidth's Communication APIs
 *
 * The version of the OpenAPI document: 1.0.0
 * Contact: [email protected]
 *
 * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
 * https://openapi-generator.tech
 * Do not edit the class manually.
 */


package com.bandwidth.sdk.api;

import com.bandwidth.sdk.ApiCallback;
import com.bandwidth.sdk.ApiClient;
import com.bandwidth.sdk.ApiException;
import com.bandwidth.sdk.ApiResponse;
import com.bandwidth.sdk.Configuration;
import com.bandwidth.sdk.Pair;
import com.bandwidth.sdk.ProgressRequestBody;
import com.bandwidth.sdk.ProgressResponseBody;

import com.google.gson.reflect.TypeToken;

import java.io.IOException;


import java.io.File;
import com.bandwidth.sdk.model.Media;
import com.bandwidth.sdk.model.MessagingRequestError;

import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class MediaApi {
    private ApiClient localVarApiClient;
    private int localHostIndex;
    private String localCustomBaseUrl;

    public MediaApi() {
        this(Configuration.getDefaultApiClient());
    }

    public MediaApi(ApiClient apiClient) {
        this.localVarApiClient = apiClient;
    }

    public ApiClient getApiClient() {
        return localVarApiClient;
    }

    public void setApiClient(ApiClient apiClient) {
        this.localVarApiClient = apiClient;
    }

    public int getHostIndex() {
        return localHostIndex;
    }

    public void setHostIndex(int hostIndex) {
        this.localHostIndex = hostIndex;
    }

    public String getCustomBaseUrl() {
        return localCustomBaseUrl;
    }

    public void setCustomBaseUrl(String customBaseUrl) {
        this.localCustomBaseUrl = customBaseUrl;
    }

    /**
     * Build call for deleteMedia
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param _callback Callback for upload/download progress
     * @return Call to execute
     * @throws ApiException If fail to serialize the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call deleteMediaCall(String accountId, String mediaId, final ApiCallback _callback) throws ApiException {
        String basePath = null;
        // Operation Servers
        String[] localBasePaths = new String[] { "https://messaging.bandwidth.com/api/v2" };

        // Determine Base Path to Use
        if (localCustomBaseUrl != null){
            basePath = localCustomBaseUrl;
        } else if ( localBasePaths.length > 0 ) {
            basePath = localBasePaths[localHostIndex];
        } else {
            basePath = null;
        }

        Object localVarPostBody = null;

        // create path and map variables
        String localVarPath = "/users/{accountId}/media/{mediaId}"
            .replace("{" + "accountId" + "}", localVarApiClient.escapeString(accountId.toString()))
            .replace("{" + "mediaId" + "}", localVarApiClient.escapeString(mediaId.toString()));

        List localVarQueryParams = new ArrayList();
        List localVarCollectionQueryParams = new ArrayList();
        Map localVarHeaderParams = new HashMap();
        Map localVarCookieParams = new HashMap();
        Map localVarFormParams = new HashMap();

        final String[] localVarAccepts = {
            "application/json"
        };
        final String localVarAccept = localVarApiClient.selectHeaderAccept(localVarAccepts);
        if (localVarAccept != null) {
            localVarHeaderParams.put("Accept", localVarAccept);
        }

        final String[] localVarContentTypes = {
        };
        final String localVarContentType = localVarApiClient.selectHeaderContentType(localVarContentTypes);
        if (localVarContentType != null) {
            localVarHeaderParams.put("Content-Type", localVarContentType);
        }

        String[] localVarAuthNames = new String[] { "Basic" };
        return localVarApiClient.buildCall(basePath, localVarPath, "DELETE", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarCookieParams, localVarFormParams, localVarAuthNames, _callback);
    }

    @SuppressWarnings("rawtypes")
    private okhttp3.Call deleteMediaValidateBeforeCall(String accountId, String mediaId, final ApiCallback _callback) throws ApiException {
        // verify the required parameter 'accountId' is set
        if (accountId == null) {
            throw new ApiException("Missing the required parameter 'accountId' when calling deleteMedia(Async)");
        }

        // verify the required parameter 'mediaId' is set
        if (mediaId == null) {
            throw new ApiException("Missing the required parameter 'mediaId' when calling deleteMedia(Async)");
        }

        return deleteMediaCall(accountId, mediaId, _callback);

    }

    /**
     * Delete Media
     * Deletes a media file from Bandwidth API server. Make sure you don't have any application scripts still using the media before you delete.  If you accidentally delete a media file you can immediately upload a new file with the same name.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public void deleteMedia(String accountId, String mediaId) throws ApiException {
        deleteMediaWithHttpInfo(accountId, mediaId);
    }

    /**
     * Delete Media
     * Deletes a media file from Bandwidth API server. Make sure you don't have any application scripts still using the media before you delete.  If you accidentally delete a media file you can immediately upload a new file with the same name.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @return ApiResponse<Void>
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public ApiResponse deleteMediaWithHttpInfo(String accountId, String mediaId) throws ApiException {
        okhttp3.Call localVarCall = deleteMediaValidateBeforeCall(accountId, mediaId, null);
        return localVarApiClient.execute(localVarCall);
    }

    /**
     * Delete Media (asynchronously)
     * Deletes a media file from Bandwidth API server. Make sure you don't have any application scripts still using the media before you delete.  If you accidentally delete a media file you can immediately upload a new file with the same name.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param _callback The callback to be executed when the API call finishes
     * @return The request call
     * @throws ApiException If fail to process the API call, e.g. serializing the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call deleteMediaAsync(String accountId, String mediaId, final ApiCallback _callback) throws ApiException {

        okhttp3.Call localVarCall = deleteMediaValidateBeforeCall(accountId, mediaId, _callback);
        localVarApiClient.executeAsync(localVarCall, _callback);
        return localVarCall;
    }
    /**
     * Build call for getMedia
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param _callback Callback for upload/download progress
     * @return Call to execute
     * @throws ApiException If fail to serialize the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call getMediaCall(String accountId, String mediaId, final ApiCallback _callback) throws ApiException {
        String basePath = null;
        // Operation Servers
        String[] localBasePaths = new String[] { "https://messaging.bandwidth.com/api/v2" };

        // Determine Base Path to Use
        if (localCustomBaseUrl != null){
            basePath = localCustomBaseUrl;
        } else if ( localBasePaths.length > 0 ) {
            basePath = localBasePaths[localHostIndex];
        } else {
            basePath = null;
        }

        Object localVarPostBody = null;

        // create path and map variables
        String localVarPath = "/users/{accountId}/media/{mediaId}"
            .replace("{" + "accountId" + "}", localVarApiClient.escapeString(accountId.toString()))
            .replace("{" + "mediaId" + "}", localVarApiClient.escapeString(mediaId.toString()));

        List localVarQueryParams = new ArrayList();
        List localVarCollectionQueryParams = new ArrayList();
        Map localVarHeaderParams = new HashMap();
        Map localVarCookieParams = new HashMap();
        Map localVarFormParams = new HashMap();

        final String[] localVarAccepts = {
            "application/octet-stream",
            "application/json"
        };
        final String localVarAccept = localVarApiClient.selectHeaderAccept(localVarAccepts);
        if (localVarAccept != null) {
            localVarHeaderParams.put("Accept", localVarAccept);
        }

        final String[] localVarContentTypes = {
        };
        final String localVarContentType = localVarApiClient.selectHeaderContentType(localVarContentTypes);
        if (localVarContentType != null) {
            localVarHeaderParams.put("Content-Type", localVarContentType);
        }

        String[] localVarAuthNames = new String[] { "Basic" };
        return localVarApiClient.buildCall(basePath, localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarCookieParams, localVarFormParams, localVarAuthNames, _callback);
    }

    @SuppressWarnings("rawtypes")
    private okhttp3.Call getMediaValidateBeforeCall(String accountId, String mediaId, final ApiCallback _callback) throws ApiException {
        // verify the required parameter 'accountId' is set
        if (accountId == null) {
            throw new ApiException("Missing the required parameter 'accountId' when calling getMedia(Async)");
        }

        // verify the required parameter 'mediaId' is set
        if (mediaId == null) {
            throw new ApiException("Missing the required parameter 'mediaId' when calling getMedia(Async)");
        }

        return getMediaCall(accountId, mediaId, _callback);

    }

    /**
     * Get Media
     * Downloads a media file you previously uploaded.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @return File
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public File getMedia(String accountId, String mediaId) throws ApiException {
        ApiResponse localVarResp = getMediaWithHttpInfo(accountId, mediaId);
        return localVarResp.getData();
    }

    /**
     * Get Media
     * Downloads a media file you previously uploaded.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @return ApiResponse<File>
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public ApiResponse getMediaWithHttpInfo(String accountId, String mediaId) throws ApiException {
        okhttp3.Call localVarCall = getMediaValidateBeforeCall(accountId, mediaId, null);
        Type localVarReturnType = new TypeToken(){}.getType();
        return localVarApiClient.execute(localVarCall, localVarReturnType);
    }

    /**
     * Get Media (asynchronously)
     * Downloads a media file you previously uploaded.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param _callback The callback to be executed when the API call finishes
     * @return The request call
     * @throws ApiException If fail to process the API call, e.g. serializing the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call getMediaAsync(String accountId, String mediaId, final ApiCallback _callback) throws ApiException {

        okhttp3.Call localVarCall = getMediaValidateBeforeCall(accountId, mediaId, _callback);
        Type localVarReturnType = new TypeToken(){}.getType();
        localVarApiClient.executeAsync(localVarCall, localVarReturnType, _callback);
        return localVarCall;
    }
    /**
     * Build call for listMedia
     * @param accountId Your Bandwidth Account ID. (required)
     * @param continuationToken Continuation token used to retrieve subsequent media. (optional)
     * @param _callback Callback for upload/download progress
     * @return Call to execute
     * @throws ApiException If fail to serialize the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   * Continuation-Token - Continuation token used to retrieve subsequent media. 
  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call listMediaCall(String accountId, String continuationToken, final ApiCallback _callback) throws ApiException {
        String basePath = null;
        // Operation Servers
        String[] localBasePaths = new String[] { "https://messaging.bandwidth.com/api/v2" };

        // Determine Base Path to Use
        if (localCustomBaseUrl != null){
            basePath = localCustomBaseUrl;
        } else if ( localBasePaths.length > 0 ) {
            basePath = localBasePaths[localHostIndex];
        } else {
            basePath = null;
        }

        Object localVarPostBody = null;

        // create path and map variables
        String localVarPath = "/users/{accountId}/media"
            .replace("{" + "accountId" + "}", localVarApiClient.escapeString(accountId.toString()));

        List localVarQueryParams = new ArrayList();
        List localVarCollectionQueryParams = new ArrayList();
        Map localVarHeaderParams = new HashMap();
        Map localVarCookieParams = new HashMap();
        Map localVarFormParams = new HashMap();

        if (continuationToken != null) {
            localVarHeaderParams.put("Continuation-Token", localVarApiClient.parameterToString(continuationToken));
        }

        final String[] localVarAccepts = {
            "application/json"
        };
        final String localVarAccept = localVarApiClient.selectHeaderAccept(localVarAccepts);
        if (localVarAccept != null) {
            localVarHeaderParams.put("Accept", localVarAccept);
        }

        final String[] localVarContentTypes = {
        };
        final String localVarContentType = localVarApiClient.selectHeaderContentType(localVarContentTypes);
        if (localVarContentType != null) {
            localVarHeaderParams.put("Content-Type", localVarContentType);
        }

        String[] localVarAuthNames = new String[] { "Basic" };
        return localVarApiClient.buildCall(basePath, localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarCookieParams, localVarFormParams, localVarAuthNames, _callback);
    }

    @SuppressWarnings("rawtypes")
    private okhttp3.Call listMediaValidateBeforeCall(String accountId, String continuationToken, final ApiCallback _callback) throws ApiException {
        // verify the required parameter 'accountId' is set
        if (accountId == null) {
            throw new ApiException("Missing the required parameter 'accountId' when calling listMedia(Async)");
        }

        return listMediaCall(accountId, continuationToken, _callback);

    }

    /**
     * List Media
     * Gets a list of your media files. No query parameters are supported.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param continuationToken Continuation token used to retrieve subsequent media. (optional)
     * @return List<Media>
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   * Continuation-Token - Continuation token used to retrieve subsequent media. 
  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public List listMedia(String accountId, String continuationToken) throws ApiException {
        ApiResponse> localVarResp = listMediaWithHttpInfo(accountId, continuationToken);
        return localVarResp.getData();
    }

    /**
     * List Media
     * Gets a list of your media files. No query parameters are supported.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param continuationToken Continuation token used to retrieve subsequent media. (optional)
     * @return ApiResponse<List<Media>>
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   * Continuation-Token - Continuation token used to retrieve subsequent media. 
  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public ApiResponse> listMediaWithHttpInfo(String accountId, String continuationToken) throws ApiException {
        okhttp3.Call localVarCall = listMediaValidateBeforeCall(accountId, continuationToken, null);
        Type localVarReturnType = new TypeToken>(){}.getType();
        return localVarApiClient.execute(localVarCall, localVarReturnType);
    }

    /**
     * List Media (asynchronously)
     * Gets a list of your media files. No query parameters are supported.
     * @param accountId Your Bandwidth Account ID. (required)
     * @param continuationToken Continuation token used to retrieve subsequent media. (optional)
     * @param _callback The callback to be executed when the API call finishes
     * @return The request call
     * @throws ApiException If fail to process the API call, e.g. serializing the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         200  OK   * Continuation-Token - Continuation token used to retrieve subsequent media. 
  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call listMediaAsync(String accountId, String continuationToken, final ApiCallback> _callback) throws ApiException {

        okhttp3.Call localVarCall = listMediaValidateBeforeCall(accountId, continuationToken, _callback);
        Type localVarReturnType = new TypeToken>(){}.getType();
        localVarApiClient.executeAsync(localVarCall, localVarReturnType, _callback);
        return localVarCall;
    }
    /**
     * Build call for uploadMedia
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param body  (required)
     * @param contentType The media type of the entity-body. (optional)
     * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional)
     * @param _callback Callback for upload/download progress
     * @return Call to execute
     * @throws ApiException If fail to serialize the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call uploadMediaCall(String accountId, String mediaId, File body, String contentType, String cacheControl, final ApiCallback _callback) throws ApiException {
        String basePath = null;
        // Operation Servers
        String[] localBasePaths = new String[] { "https://messaging.bandwidth.com/api/v2" };

        // Determine Base Path to Use
        if (localCustomBaseUrl != null){
            basePath = localCustomBaseUrl;
        } else if ( localBasePaths.length > 0 ) {
            basePath = localBasePaths[localHostIndex];
        } else {
            basePath = null;
        }

        Object localVarPostBody = body;

        // create path and map variables
        String localVarPath = "/users/{accountId}/media/{mediaId}"
            .replace("{" + "accountId" + "}", localVarApiClient.escapeString(accountId.toString()))
            .replace("{" + "mediaId" + "}", localVarApiClient.escapeString(mediaId.toString()));

        List localVarQueryParams = new ArrayList();
        List localVarCollectionQueryParams = new ArrayList();
        Map localVarHeaderParams = new HashMap();
        Map localVarCookieParams = new HashMap();
        Map localVarFormParams = new HashMap();

        if (contentType != null) {
            localVarHeaderParams.put("Content-Type", localVarApiClient.parameterToString(contentType));
        }

        if (cacheControl != null) {
            localVarHeaderParams.put("Cache-Control", localVarApiClient.parameterToString(cacheControl));
        }

        final String[] localVarAccepts = {
            "application/json"
        };
        final String localVarAccept = localVarApiClient.selectHeaderAccept(localVarAccepts);
        if (localVarAccept != null) {
            localVarHeaderParams.put("Accept", localVarAccept);
        }

        final String[] localVarContentTypes = {
            "application/json",
            "application/ogg",
            "application/pdf",
            "application/rtf",
            "application/zip",
            "application/x-tar",
            "application/xml",
            "application/gzip",
            "application/x-bzip2",
            "application/x-gzip",
            "application/smil",
            "application/javascript",
            "audio/mp4",
            "audio/mpeg",
            "audio/ogg",
            "audio/flac",
            "audio/webm",
            "audio/wav",
            "audio/amr",
            "audio/3gpp",
            "image/bmp",
            "image/gif",
            "image/jpeg",
            "image/pjpeg",
            "image/png",
            "image/svg+xml",
            "image/tiff",
            "image/webp",
            "image/x-icon",
            "text/css",
            "text/csv",
            "text/calendar",
            "text/plain",
            "text/javascript",
            "text/vcard",
            "text/vnd.wap.wml",
            "text/xml",
            "video/avi",
            "video/mp4",
            "video/mpeg",
            "video/ogg",
            "video/quicktime",
            "video/webm",
            "video/x-ms-wmv"
        };
        final String localVarContentType = localVarApiClient.selectHeaderContentType(localVarContentTypes);
        if (localVarContentType != null) {
            localVarHeaderParams.put("Content-Type", localVarContentType);
        }

        String[] localVarAuthNames = new String[] { "Basic" };
        return localVarApiClient.buildCall(basePath, localVarPath, "PUT", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarCookieParams, localVarFormParams, localVarAuthNames, _callback);
    }

    @SuppressWarnings("rawtypes")
    private okhttp3.Call uploadMediaValidateBeforeCall(String accountId, String mediaId, File body, String contentType, String cacheControl, final ApiCallback _callback) throws ApiException {
        // verify the required parameter 'accountId' is set
        if (accountId == null) {
            throw new ApiException("Missing the required parameter 'accountId' when calling uploadMedia(Async)");
        }

        // verify the required parameter 'mediaId' is set
        if (mediaId == null) {
            throw new ApiException("Missing the required parameter 'mediaId' when calling uploadMedia(Async)");
        }

        // verify the required parameter 'body' is set
        if (body == null) {
            throw new ApiException("Missing the required parameter 'body' when calling uploadMedia(Async)");
        }

        return uploadMediaCall(accountId, mediaId, body, contentType, cacheControl, _callback);

    }

    /**
     * Upload Media
     * Upload a file. You may add headers to the request in order to provide some control to your media file.  If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten.  A list of supported media types can be found [here](https://support.bandwidth.com/hc/en-us/articles/360014128994-What-MMS-file-types-are-supported-).
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param body  (required)
     * @param contentType The media type of the entity-body. (optional)
     * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional)
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public void uploadMedia(String accountId, String mediaId, File body, String contentType, String cacheControl) throws ApiException {
        uploadMediaWithHttpInfo(accountId, mediaId, body, contentType, cacheControl);
    }

    /**
     * Upload Media
     * Upload a file. You may add headers to the request in order to provide some control to your media file.  If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten.  A list of supported media types can be found [here](https://support.bandwidth.com/hc/en-us/articles/360014128994-What-MMS-file-types-are-supported-).
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param body  (required)
     * @param contentType The media type of the entity-body. (optional)
     * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional)
     * @return ApiResponse<Void>
     * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public ApiResponse uploadMediaWithHttpInfo(String accountId, String mediaId, File body, String contentType, String cacheControl) throws ApiException {
        okhttp3.Call localVarCall = uploadMediaValidateBeforeCall(accountId, mediaId, body, contentType, cacheControl, null);
        return localVarApiClient.execute(localVarCall);
    }

    /**
     * Upload Media (asynchronously)
     * Upload a file. You may add headers to the request in order to provide some control to your media file.  If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten.  A list of supported media types can be found [here](https://support.bandwidth.com/hc/en-us/articles/360014128994-What-MMS-file-types-are-supported-).
     * @param accountId Your Bandwidth Account ID. (required)
     * @param mediaId Media ID to retrieve. (required)
     * @param body  (required)
     * @param contentType The media type of the entity-body. (optional)
     * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional)
     * @param _callback The callback to be executed when the API call finishes
     * @return The request call
     * @throws ApiException If fail to process the API call, e.g. serializing the request body object
     * @http.response.details
     
         Status Code  Description  Response Headers 
         204  No Content   -  
         400  Bad Request   -  
         401  Unauthorized   -  
         403  Forbidden   -  
         404  Not Found   -  
         406  Not Acceptable   -  
         415  Unsupported Media Type   -  
         429  Too Many Requests   -  
         500  Internal Server Error   -  
     
     */
    public okhttp3.Call uploadMediaAsync(String accountId, String mediaId, File body, String contentType, String cacheControl, final ApiCallback _callback) throws ApiException {

        okhttp3.Call localVarCall = uploadMediaValidateBeforeCall(accountId, mediaId, body, contentType, cacheControl, _callback);
        localVarApiClient.executeAsync(localVarCall, _callback);
        return localVarCall;
    }
}
Status Code	Description	Response Headers
204	No Content	-
400	Bad Request	-
401	Unauthorized	-
403	Forbidden	-
404	Not Found	-
406	Not Acceptable	-
415	Unsupported Media Type	-
429	Too Many Requests	-
500	Internal Server Error	-