Appwrite 2.0 on Product Hunt_

Skip to content
post

Create file

Endpoint

posthttps://<REGION>.cloud.appwrite.io/v1/storage/buckets/{bucketId}/files

Description

Create a new file. Before using this route, you should create a new bucket resource using either a server integration API or directly from your Appwrite console.

Larger files should be uploaded using multiple requests with the content-range header to send a partial request with a maximum supported chunk of 5MB. The content-range header values should always be in bytes.

When the first request is sent, the server will return the File object, and the subsequent part request must include the file's id in x-appwrite-id header to allow the server to know that the partial upload is for the existing file and not for a new one.

If you're creating a new file using one of the Appwrite SDKs, all the chunking logic will be managed by the SDK internally.

Required scopes

files.write

Authentication

Initialize the Appwrite client with setProject() and ensure the user is signed in. The SDK sends the session header automatically after login.

Rate limit

Up to 60 requests per minute for each IP address calling this endpoint.
Server API key requests bypass this rate limit.

Path

string
Required

Storage bucket unique ID. You can create a new storage bucket using the Storage service server integration.

Body

string
Required

File 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

Binary file. Appwrite SDKs provide helpers to handle file input. Learn about file input.

array

An array of permission strings. By default, only the current user is granted all permissions. Learn more about permissions.

Status
Content type
201
application/json

File

Name
Type
Description
string

File ID.

string

Bucket ID.

string

File creation date in ISO 8601 format.

string

File update date in ISO 8601 format.

arrayof string

File permissions. Learn more about permissions.

string

File name.

string

File MD5 signature.

string

File mime type.

integer

File original size in bytes.

integer

Total number of chunks available

integer

Total number of chunks uploaded

HTTP
POST /v1/storage/buckets/{bucketId}/files HTTP/1.1
Host: cloud.appwrite.io
Content-Type: multipart/form-data; boundary="cec8e8123c05ba25"
X-Appwrite-Response-Format: 1.6.0
X-Appwrite-Project: <YOUR_PROJECT_ID>
X-Appwrite-Session: 
X-Appwrite-JWT: <YOUR_JWT>
Content-Length: *Length of your entity body in bytes*


--cec8e8123c05ba25
Content-Disposition: form-data; name="fileId"


"<FILE_ID>"


--cec8e8123c05ba25
Content-Disposition: form-data; name="file"


cf 94 84 24 8d c4 91 10 0f dc 54 26 6c 8e 4b bc 
e8 ee 55 94 29 e7 94 89 19 26 28 01 26 29 3f 16...


--cec8e8123c05ba25
Content-Disposition: form-data; name="permissions[]"


["read(\"any\")"]


--cec8e8123c05ba25--