---
id: usage
title: Usage
toc_max_heading_level: 2
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
API documentation for Supabase Storage
## Create a bucket {#create-a-bucket}
```
/bucket/
```
### Responses
```
200
```
```
400
```
## Gets all buckets {#gets-all-buckets}
```
/bucket/
```
### Responses
```
200
```
```
400
```
## Empty a bucket {#empty-a-bucket}
```
/bucket/{bucketId}/empty
```
### Responses
```
200
```
```
400
```
## Get details of a bucket {#get-details-of-a-bucket}
```
/bucket/{bucketId}
```
### Responses
```
200
```
```
400
```
## Update properties of a bucket {#update-properties-of-a-bucket}
```
/bucket/{bucketId}
```
### Responses
```
200
```
```
400
```
## Delete a bucket {#delete-a-bucket}
```
/bucket/{bucketId}
```
### Responses
```
200
```
```
400
```
## Delete an object {#delete-an-object}
```
/object/{bucketName}/{wildcard}
```
### Responses
```
200
```
```
400
```
## Deprecated (use GET /object/authenticated/{bucketName} instead): Retrieve an object {#deprecated-use-get-objectauthenticatedbucketname-instead-retrieve-an-object}
```
/object/{bucketName}/{wildcard}
```
### Responses
```
400
```
## Update the object at an existing key {#update-the-object-at-an-existing-key}
```
/object/{bucketName}/{wildcard}
```
### Responses
```
200
```
```
400
```
## Upload a new object {#upload-a-new-object}
```
/object/{bucketName}/{wildcard}
```
### Responses
```
200
```
```
400
```
## Delete multiple objects {#delete-multiple-objects}
```
/object/{bucketName}
```
### Responses
```
200
```
```
400
```
## Retrieve an object {#retrieve-an-object}
```
/object/authenticated/{bucketName}/{wildcard}
```
### Responses
```
400
```
## Generate a presigned url to retrieve an object {#generate-a-presigned-url-to-retrieve-an-object}
```
/object/sign/{bucketName}/{wildcard}
```
### Responses
```
200
```
```
400
```
## Retrieve an object via a presigned URL {#retrieve-an-object-via-a-presigned-url}
```
/object/sign/{bucketName}/{wildcard}
```
### Responses
```
400
```
## Generate presigned urls to retrieve objects {#generate-presigned-urls-to-retrieve-objects}
```
/object/sign/{bucketName}
```
### Responses
```
200
```
```
400
```
## Moves an object {#moves-an-object}
```
/object/move
```
### Responses
```
200
```
```
400
```
## Search for objects under a prefix {#search-for-objects-under-a-prefix}
```
/object/list/{bucketName}
```
### Responses
```
200
```
```
400
```
## Copies an object {#copies-an-object}
```
/object/copy
```
### Responses
```
200
```
```
400
```
## Retrieve an object from a public bucket {#retrieve-an-object-from-a-public-bucket}
```
/object/public/{bucketName}/{wildcard}
```
### Responses
```
400
```