Set Versioning

Enable, suspend, or disable versioning for a bucket.

Endpoint	Method	Admin Required
`/api/v1/buckets/:bucketName/versioning`	PUT	No

Updates the versioning status of a bucket you own.

Path Parameters

bucketName

string required

The name of the bucket.

Request Body

status

string required

New versioning status: Enabled, Suspended, or Disabled.

Example

{
    "status": "Enabled"
}

Response

Returns the updated versioning status:

{
    "status": "Enabled"
}

Versioning Behavior

Status	Effect
`Enabled`	All object uploads create new versions. Deletes create delete markers.
`Suspended`	New uploads don't create versions. Existing versions are preserved.
`Disabled`	Versioning is completely disabled. Overwrites replace objects.

Once versioning has been enabled on a bucket, it cannot be fully disabled—only suspended. Use Suspended to stop creating new versions while keeping existing ones.

Errors

Status	Reason
`400`	Invalid versioning status
`404`	Bucket not found (or not owned by you)

Get Versioning

Get the versioning status of a bucket.

List Objects

List objects in a bucket with prefix and pagination support.