Skip to main content
GET
https://api.golivecosmos.com
/
v1
/
uploads
curl --location --request GET 'https://api.golivecosmos.com/v1/uploads?extension=mp4' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \

{
  "type": "upload",
  "attributes": {
    "signedUrl": "https://production-cosmos-assets.s3.us-east-1.amazonaws.com/production/64249607732dd0eb4b42ce02/7866779?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAUHGZCRDQ7C36EENS%2F20230606%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230606T182458Z&X-Amz-Expires=300&X-Amz-Signature=8ae1e1fdc3fa17a679bbeefef6bf03b6093add9f4efc158bbe32a37bf2c9a9b3&X-Amz-SignedHeaders=host&x-id=PutObject",
    "key": "production/64249607732dd0eb4b42ce02/7866779"
  }
}
Check out the Uploads guide for step-by-step instructions on how to upload files to Cosmos for storage.

​
Parameters

​
extension
string
required
The extension query is used to set a file extension for your uploaded file. Make sure the extension matches the extension of your file.
Supported extensions for video are mp4, mov, webm, and ogg.
Supported extensions for images are jpeg, png, webp, and gif.

​
Response

​
type
string
Indicates the type of document returned in the response.
​
attributes
object
The attributes of the Upload document response.
curl --location --request GET 'https://api.golivecosmos.com/v1/uploads?extension=mp4' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \

{
  "type": "upload",
  "attributes": {
    "signedUrl": "https://production-cosmos-assets.s3.us-east-1.amazonaws.com/production/64249607732dd0eb4b42ce02/7866779?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAUHGZCRDQ7C36EENS%2F20230606%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230606T182458Z&X-Amz-Expires=300&X-Amz-Signature=8ae1e1fdc3fa17a679bbeefef6bf03b6093add9f4efc158bbe32a37bf2c9a9b3&X-Amz-SignedHeaders=host&x-id=PutObject",
    "key": "production/64249607732dd0eb4b42ce02/7866779"
  }
}