# Contabo Object Storages API

**Canonical:** https://apis.io/apis/contabo/contabo-object-storages-api/  
**Provider:** Contabo — https://apis.io/providers/contabo/  
**Base URL:** https://api.contabo.com  
**Documentation:** https://api.contabo.com/

Contabo Object Storages API is one of 39 APIs that [Contabo](https://apis.io/providers/contabo/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Object Storages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Manage S3 compatible Object Storage. With the Object Storage API you can create Object Storage in different locations. Please note that you can only have one Object Storage per location. Furthermore you can increase the amount of storage space and control the autoscaling feature which allows to automatically perform a monthly upgrade of the disk space to the specified maximum. You might also inspect the usage. This API is not the S3 API itself. For accessing the S3 API directly or with S3 compatible tools like `aws` cli after and after having created / upgraded your Object Storage please use the S3 URL from this Storage API and refer to the User Mangement API to retrieve the S3 credentials.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/object-storages` | List all your object storages |
| POST | `/v1/object-storages` | Create a new object storage |
| GET | `/v1/data-centers` | List data centers |
| GET | `/v1/object-storages/{objectStorageId}` | Get specific object storage by its id |
| PATCH | `/v1/object-storages/{objectStorageId}` | Modifies the display name of object storage |
| POST | `/v1/object-storages/{objectStorageId}/resize` | Upgrade object storage size resp. update autoscaling settings |
| GET | `/v1/object-storages/{objectStorageId}/stats` | List usage statistics about the specified object storage |
| PATCH | `/v1/object-storages/{objectStorageId}/cancel` | Cancels the specified object storage at the next possible date |

## Machine-readable artifacts (9)

- **OpenAPI** — https://artifacts.apis.io/contabo/openapi/contabo-object-storages-api-openapi.yml
- **Documentation** — https://api.contabo.com/
- **CLI** — https://github.com/contabo/cntb
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-create-instance-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-handle-create-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-handle-patch-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-create-user-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-reinstall-instance-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-update-user-request-schema.json

## Other Contabo APIs (12)

- [Contabo Check Collection Templates API](https://apis.io/apis/contabo/contabo-check-collection-templates-api/)
- [Contabo Check Collections API](https://apis.io/apis/contabo/contabo-check-collections-api/)
- [Contabo Checks API](https://apis.io/apis/contabo/contabo-checks-api/)
- [Contabo DNS API](https://apis.io/apis/contabo/contabo-dns-api/)
- [Contabo DNS Audits API](https://apis.io/apis/contabo/contabo-dns-audits-api/)
- [Contabo Domains API](https://apis.io/apis/contabo/contabo-domains-api/)
- [Contabo Domains Audits API](https://apis.io/apis/contabo/contabo-domains-audits-api/)
- [Contabo Firewalls API](https://apis.io/apis/contabo/contabo-firewalls-api/)
- [Contabo Firewalls Audits API](https://apis.io/apis/contabo/contabo-firewalls-audits-api/)
- [Contabo Handles API](https://apis.io/apis/contabo/contabo-handles-api/)
- [Contabo Handles Audits API](https://apis.io/apis/contabo/contabo-handles-audits-api/)
- [Contabo Images API](https://apis.io/apis/contabo/contabo-images-api/)

## Tags

Object Storages

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/contabo/contabo-object-storages-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/contabo/.