Upload files to a storage path
Uploads one or more files to the specified path within the user's connected object store. The request body must be `Content-Type: multipart/form-data` with: - A **`path`** text field — the destination directory (e.g. `"data/raw/2024/"`). - One or more **`files`** binary parts — the files to upload. **Required scope:** `storage:write`
Authorization
BearerAuth Security scheme for OpenAPI endpoints. Validates both JWT tokens and API keys.
In: header
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/storages/uploads" \ -F path="string" \ -F files="[ \"string\" ]"{}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}Undo a recent promote
Flips a just-promoted config back to the promoter's personal ownership — mistake recovery for "shared to the wrong place". Only the promoter may undo, and only within 15 minutes of the promote; a workspace re-attach extinguishes the window. After the window, sharing is one-way by design: teammates may have built on the shared config, so the loud teardown path is DELETE. **Required scope:** `storage_configs:share`
List objects from a storage configuration
Returns objects from the configured object store with optional filtering by path prefix, file extensions, and pagination support. Use `delimiter=true` for directory-style listing.