v1

latestOpenAPI 3.1.02026-08-0421263172.4 KB
objects

Upload object

Uploads an object. The object must be 1 GiB or smaller.

post/api/v1/objects/{objectPath}

Path parameters

objectPathstring required

Path of the Object that is to be uploaded.

Headers

Authorizationstring required

Bearer authentication

Time-To-Liveinteger

An optional expiry TTL associated with an object. The value represents the number of nanoseconds the object will exist in the local store. If no TTL is supplied, the server applies a default TTL. In most cases, the default TTL is 90 days. However, it might be higher or lower, depending on the retention requirements of your environment.

Distribution-Mode'force'

Controls how the object is distributed across the mesh. If set to force, the object will be force distributed to all nodes. Force-distributed objects are subject to a size limit.

Response

Successful upload

size_bytesinteger required
last_updated_atstring date-time required
expiry_timestring date-time