File Management

List all buckets accessible to the authenticated user or API key.

{
  "success": true,
  "data": [
    { "id": "bkt_01j9", "name": "assets", "fileCount": 42, "size": 128000000 }
  ]
}

Create a new bucket. Bucket names must be unique within a tenant.

{ "success": true, "data": { "id": "bkt_02k1", "name": "uploads" } }

Rename a bucket.

Delete a bucket and all its contents. This action is irreversible.

List objects inside a bucket. Supports pagination and path prefix filtering.

{
  "success": true,
  "data": [
    { "id": "obj_01j9", "name": "photo.jpg", "size": 2048000, "type": "file" },
    { "id": "obj_02k1", "name": "images/", "type": "directory" }
  ]
}

Create an empty directory inside a bucket.

Generate a time-limited presigned URL for public file access.

{
  "success": true,
  "data": {
    "url": "https://cdn.stashly.io/api/serve?token=hmac_...",
    "expiresAt": "2025-05-29T15:00:00Z"
  }
}

Directly download a file. Returns the file binary with appropriate Content-Type headers.

Rename a file or directory.

Move an object to a different path within the same bucket.

Copy an object to a new key within the same bucket.

Move an object to trash. It can be restored from the Trash API.

Delete multiple objects in a single request.

Move multiple objects to a destination directory.

Copy multiple objects to a destination directory.

List items currently in trash.

Restore an item from trash back to its original location.

Permanently delete all items in trash. This is irreversible.

Permanently delete a single trash item.

Serve a file using a presigned token. This endpoint is public — use presigned URLs to share files externally.