Skip to content
post

Create bucket

Endpoint

posthttps://<REGION>.cloud.appwrite.io/v1/storage/buckets

Description

Create a new storage bucket.

Required scopes

buckets.write

Authentication

Initialize the Appwrite client with setProject() and a server API key (setKey()). For direct REST calls, send X-Appwrite-Project and X-Appwrite-Key.

Parameters

string
Required

Unique Id. Choose a custom ID or generate a random ID with ID.unique(). Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.

string
Required

Bucket name

array

An array of permission strings. By default, no user is granted with any permissions. Learn more about permissions.

boolean

Enables configuring permissions for individual file. A user needs one of file or bucket level permissions to access a file. Learn more about permissions.

boolean

Is bucket enabled? When set to 'disabled', users cannot access the files in this bucket but Server SDKs with and API key can still access the bucket. No files are lost when this is toggled.

integer

Maximum file size allowed in bytes. Maximum allowed value is 0B.

array

Allowed file extensions. Maximum of 100 extensions are allowed, each 64 characters long.

enum

Compression algorithm chosen for compression. Can be one of none, gzip, or zstd, For file size above 20MB compression is skipped even if it's enabled

boolean

Is encryption enabled? For file size above 20MB encryption is skipped even if it's enabled

boolean

Is virus scanning enabled? For file size above 20MB AntiVirus scanning is skipped even if it's enabled

boolean

Are image transformations enabled?

Status
Content type
201
application/json

Bucket

Name
Type
Description
string

Bucket ID.

string

Bucket creation time in ISO 8601 format.

string

Bucket update date in ISO 8601 format.

arrayof string

Bucket permissions. Learn more about permissions.

boolean

Whether file-level security is enabled. Learn more about permissions.

string

Bucket name.

boolean

Bucket enabled.

integer

Maximum file size supported.

arrayof string

Allowed file extensions.

string

Compression algorithm chosen for compression. Will be one of none, gzip, or zstd.

boolean

Bucket is encrypted.

boolean

Virus scanning is enabled.

boolean

Image transformations are enabled.

integer

Total size of this bucket in bytes.

Python
from appwrite.client import Client
from appwrite.services.storage import Storage
from appwrite.models import Bucket
from appwrite.enums import Compression
from appwrite.permission import Permission
from appwrite.role import Role


client = Client()
client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key


storage = Storage(client)


result: Bucket = storage.create_bucket(
    bucket_id = '<BUCKET_ID>',
    name = '<NAME>',
    permissions = [Permission.read(Role.any())], # optional
    file_security = False, # optional
    enabled = False, # optional
    maximum_file_size = 1, # optional
    allowed_file_extensions = [], # optional
    compression = Compression.NONE, # optional
    encryption = False, # optional
    antivirus = False, # optional
    transformations = False # optional
)


print(result.model_dump())