Endpoints associated with uploading media files.
The upload
endpoint provides a method for converting files from an unsupported format to a format that one of our endpoints can handle.
Files can be submitted two ways: 1. Using base64
encoding in an application/json
request. In this case, submit the base64
-encoded file contents in the content
field of the request body, and convert
can be specified either also in the body or as part of the query string. 2. Using multipart/form-data
encoding, in the same way it would be submitted using a HTML form. You may find cURL useful for this. For an example of how to do this, see one of our SDKs. In this case, specify convert
in the query string.
Note that convert
specifies the conversion to take place. That is, what the result should be compatible with and can be any of the following:
fax
mms
csv
post
postcard
All files will expire 10 minutes after being uploaded.
Parameter | In | Type | Required | Description |
---|---|---|---|---|
convert | query | string | true | none |
content | body | string | true | Base64-encoded file contents |
Refer to Status Codes for definitions of HTTP status code responses.
This endpoint requires authentication, more info...
Successful response
{- "content": "{{base64EncodedFile}}"
}