storage
0.01 USD
Create an object. Returns error if object with this name already exists. Max object size of 10MB, see Upload endpoint for larger objects. If you want to update an existing object use the `Update` endpoint
namestring
The name of the object. Use forward slash delimiter to implement a nested directory-like structure e.g. images/foo.jpg
objectstring
The contents of the object. Either base64 encoded if sending request as application/json or raw bytes if using multipart/form-data format
visibilitystring
Who can see this object? "public" or "private", defaults to "private"
urlstring
A public URL to access the object if visibility is "public"
Request
Response
{
"url": "https://example.com/foo/bar/file.jpg"
}0.000001 USD
Delete an object from space
namestring
Name of the object
Request
Response
{}0.000001 USD
Download an object via a presigned url
namestring
name of object
urlstring
presigned url
Request
Response
{
"url": "https://example.com/foo/bar/images/file.jpg"
}0.000001 USD
Retrieve meta information about an object
namestring
name of the object
objectobject
Request
Response
{
"object": {
"name": "images/file.jpg",
"modified": "2021-12-10T14:28:23.220874511Z",
"created": "2021-12-10T14:28:23.220874511Z",
"url": "https://example.com/foo/bar/images/file.jpg",
"visibility": "public"
}
}0.000001 USD
List the objects in space
prefixstring
optional prefix for the name e.g. to return all the objects in the images directory pass images/
objectsarray
Request
Response
{
"objects": [
{
"name": "images/file.jpg",
"modified": "2021-12-10T14:28:23.220874511Z",
"created": "2021-12-10T14:28:23.220874511Z",
"visibility": "public",
"url": "https://example.com/foo/bar/images/file.jpg"
},
{
"name": "images/file2.jpg",
"modified": "2021-12-10T14:27:23.220874511Z",
"created": "2021-12-10T14:27:23.220874511Z",
"visibility": "public",
"url": "https://example.com/foo/bar/images/file2.jpg"
}
]
}0.000001 USD
Read an object in space
namestring
name of the object
objectobject
The object itself
Request
Response
{
"object": {
"name": "images/file.jpg",
"modified": "2021-12-10T14:28:23.220874511Z",
"created": "2021-12-10T14:28:23.220874511Z",
"url": "https://example.com/foo/bar/images/file.jpg",
"visibility": "public",
"data": "<file bytes>"
}
}0.01 USD
Update an object. If an object with this name does not exist, creates a new one.
namestring
The name of the object. Use forward slash delimiter to implement a nested directory-like structure e.g. images/foo.jpg
objectstring
The contents of the object. Either base64 encoded if sending request as application/json or raw bytes if using multipart/form-data format
visibilitystring
Who can see this object? "public" or "private", defaults to "private"
urlstring
A public URL to access the object if visibility is "public"
Request
Response
{
"url": "https://example.com/foo/bar/images/file.jpg"
}0.01 USD
Upload a large object (> 10MB). Returns a time limited presigned URL to be used for uploading the object
namestring
visibilitystring
is this object public or private
urlstring
a presigned url to be used for uploading. To use the URL call it with HTTP PUT and pass the object as the request data
Request
Response
{
"url": "https://example.com/foo/bar/images/file.jpg"
}