# Hostingsurge Storage API

**Canonical:** https://apis.io/apis/hostingsurge-com/hostingsurge-com-storage-api/  
**Provider:** Hostingsurge — https://apis.io/providers/hostingsurge-com/  
**Base URL:** https://hostingsurge.com/api/v1  
**Documentation:** https://hostingsurge.com/developers

Hostingsurge Storage API is one of 37 APIs that [Hostingsurge](https://apis.io/providers/hostingsurge-com/) 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 Storage. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Storage API from Hostingsurge — 17 operation(s) for storage.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| GET | `/storage` | S3 endpoint, region, team limits and what is used |
| GET | `/storage/buckets` | Buckets of your team(s) |
| POST | `/storage/buckets` | Create a bucket (private by default). Its S3 name is - |
| GET | `/storage/buckets/{bucketId}` | One bucket with current usage |
| PATCH | `/storage/buckets/{bucketId}` | Change visibility (public/private), quota, object limit, CORS rules or the… |
| DELETE | `/storage/buckets/{bucketId}` | Delete a bucket and every file in it (confirm with its name). |
| GET | `/storage/buckets/{bucketId}/keys` | Access keys of a bucket (never their secrets) |
| POST | `/storage/buckets/{bucketId}/keys` | Create an S3 access key for this bucket only. |
| DELETE | `/storage/keys/{keyId}` | Revoke an access key (immediately) |
| GET | `/storage/buckets/{bucketId}/objects` | Files and folders below a prefix ("/"-delimited), paged with cursor |
| PUT | `/storage/buckets/{bucketId}/objects` | Upload one file (raw body, up to 100 MiB; Content-Type becomes the file's type). |
| POST | `/storage/buckets/{bucketId}/objects` | Write a small file (≤ 5 MiB) from JSON: {key, content, encoding: utf8\|base64… |
| DELETE | `/storage/buckets/{bucketId}/objects` | Delete one file |
| GET | `/storage/buckets/{bucketId}/objects/content` | Read a small file (≤ 1 MiB) inline: utf8 for text types, base64 otherwise |
| POST | `/storage/buckets/{bucketId}/presign` | A presigned GET (download) or PUT (upload) URL for one key, valid 1 minute to 7… |
| POST | `/storage/buckets/{bucketId}/connect` | Connect the bucket to a project: new bucket-scoped key + S3_ENDPOINT… |
| GET | `/storage/usage` | Stored bytes, egress/ingress and requests for a period (default: this month)… |
| POST | `/storage/vercel-blob-stores` | Create a Vercel Blob-compatible store for a project: unchanged @vercel/blob… |
| GET | `/storage/vercel-blob-stores` | Vercel Blob-compatible stores of your team(s) |
| GET | `/storage/vercel-blob-stores/{storeId}` | One Vercel Blob-compatible store |
| DELETE | `/storage/vercel-blob-stores/{storeId}` | Delete the store and every file in it (confirm with the store id) |
| POST | `/storage/vercel-blob-stores/{storeId}/rotate` | A new read-write token (the old one stops working within 5 seconds); update… |
| POST | `/global-configs` | Create an Edge Config / Global Config for a project: unchanged… |
| GET | `/global-configs` | Edge Configs / Global Configs of your team(s) |
| GET | `/global-configs/{configId}` | One config with its items |
| DELETE | `/global-configs/{configId}` | Delete the config |
| PATCH | `/global-configs/{configId}/items` | Create, update, upsert or delete items (live for the app within 5 seconds) |
| POST | `/global-configs/{configId}/rotate` | A new connection string (the old token stops working within 5 seconds); update… |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-storage-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-builder-visual-op-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-policy-templates-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-pending-changes-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-confirm-prices-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-collection-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-create-shop-input-body-schema.json

## Other Hostingsurge APIs (12)

- [Hostingsurge Accelerator API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-accelerator-api/)
- [Hostingsurge Agents API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-agents-api/)
- [Hostingsurge Alerts API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-alerts-api/)
- [Hostingsurge Analytics API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-analytics-api/)
- [Hostingsurge Assistant API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-assistant-api/)
- [Hostingsurge Automation API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-automation-api/)
- [Hostingsurge Backups API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-backups-api/)
- [Hostingsurge Billing API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-billing-api/)
- [Hostingsurge Builder API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-builder-api/)
- [Hostingsurge Business API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-business-api/)
- [Hostingsurge Certificates API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-certificates-api/)
- [Hostingsurge Databases API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-databases-api/)

## Tags

Storage

---

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