Enable or disable versioning for object storage buckets

Turn versioning on or off for a specific object storage bucket. Versioning is important for protecting data against accidental deletion or overwriting by saving previous versions of files.

Object Storage Bucket Settings

Context

Related endpoints

GET /api/object-storage/buckets/{name}/versioning Get versioning status for an object storage bucket GET /api/object-storage/buckets/{name} Get object storage bucket and content details DELETE /api/object-storage/buckets/{name} Delete an S3 bucket and its contents

Path Parameters

name string required Example: f13

name parameter

Headers

Accept Example

Content-Type Example

Body

required

application/json

enabled boolean required · Example: false

Responses

200

data object required

data.status string · enum required · Example: Suspended

Enabled

Suspended

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

PUT https://cloud.hostup.se/api/object-storage/buckets/{name}/versioning

For AI assistants

cURL

curl -X PUT "https://cloud.hostup.se/api/object-storage/buckets/f13/versioning" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "status": "Suspended"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "Enabled",
            "Suspended"
          ]
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body Example 1

{
  "enabled": false
}