API reference
Every REST endpoint, grouped by resource.
Base URL: https://storage-saas.manojkumarsahu97.workers.dev
Auth: Authorization: Bearer sk_live_… (except public signed-URL access).
Responses are JSON with a uniform error shape (code, message, requestId,
docsUrl), cursor pagination, and an x-request-id header. Writes accept an
Idempotency-Key header. A machine-readable
OpenAPI 3.1 spec is also available.
| Method | Path | Description |
|---|
POST | /v1/buckets | Create a bucket |
GET | /v1/buckets | List buckets |
GET | /v1/buckets/{bucket} | Get a bucket |
PATCH | /v1/buckets/{bucket} | Update a bucket |
DELETE | /v1/buckets/{bucket} | Delete a bucket (must be empty) |
| Method | Path | Description |
|---|
PUT | /v1/buckets/{bucket}/objects/{key} | Upload an object |
GET | /v1/buckets/{bucket}/objects/{key} | Download an object |
HEAD | /v1/buckets/{bucket}/objects/{key} | Object metadata |
DELETE | /v1/buckets/{bucket}/objects/{key} | Delete an object |
POST | /v1/buckets/{bucket}/objects/{key}/copy | Copy an object |
GET | /v1/buckets/{bucket}/objects | List objects (?prefix=&cursor=&limit=) |
POST | /v1/buckets/{bucket}/objects/batch-delete | Delete many |
| Method | Path | Description |
|---|
POST | /v1/buckets/{bucket}/uploads | Start a multipart upload |
PUT | /v1/buckets/{bucket}/uploads/{uploadId}/parts/{n}?key= | Upload a part |
POST | /v1/buckets/{bucket}/uploads/{uploadId}/complete | Complete |
DELETE | /v1/buckets/{bucket}/uploads/{uploadId}?key= | Abort |
| Method | Path | Description |
|---|
POST | /v1/buckets/{bucket}/sign | Issue a signed URL |
GET/PUT | /signed/{bucket}/{key}?… | Consume a signed URL (no API key) |
| Method | Path | Description |
|---|
POST | /v1/webhooks | Create a webhook (returns signingSecret once) |
GET | /v1/webhooks | List webhooks |
GET | /v1/webhooks/{id} | Get a webhook |
PATCH | /v1/webhooks/{id} | Update a webhook |
DELETE | /v1/webhooks/{id} | Delete a webhook |
| Method | Path | Description |
|---|
POST | /v1/keys | Issue a key (plaintext shown once) |
GET | /v1/keys | List keys |
DELETE | /v1/keys/{id} | Revoke a key |
| Method | Path | Description |
|---|
GET | /v1/account | Account info + current-period usage |
| Code | HTTP | Meaning |
|---|
unauthorized | 401 | Missing or invalid API key |
forbidden | 403 | Cross-tenant or disallowed access |
bucket_not_found / object_not_found | 404 | Not found |
bucket_already_exists | 409 | Duplicate bucket name |
invalid_request / invalid_key | 400 | Bad input |
payload_too_large | 413 | Body exceeds limit |
quota_exceeded | 403 | Plan storage cap reached |
rate_limited | 429 | Too many requests |