Skip to content

Object Storage (Swift) API

Swift v1 · No microversions · OpenStack Antelope (2023.1)

Base URL: https://object.{region}.rumble.cloud

Upstream reference: OpenStack Object Storage API ↗ · Error handling: API errors

S3

Looking for the S3-compatible API?

Most applications should use the S3-compatible API reference instead. It works with AWS SDKs, the AWS CLI, boto3, s3cmd, and any S3-compatible tool without OpenStack knowledge.

The Swift native API below is for users who need Swift-specific features like custom metadata headers, container ACLs, or static website hosting.

Swift endpoints

Authenticate with a Keystone token in the X-Auth-Token header. See Authentication.

GET/v1/{account}
PUT/v1/{account}/{container}
DELETE/v1/{account}/{container}
GET/v1/{account}/{container}
PUT/v1/{account}/{container}/{object}
GET/v1/{account}/{container}/{object}
DELETE/v1/{account}/{container}/{object}
COPY/v1/{account}/{container}/{object}
HEAD/v1/{account}/{container}
POST/v1/{account}/{container}
HEAD/v1/{account}/{container}/{object}
POST/v1/{account}/{container}/{object}