Create File

POST

/storage/files

storage

Create a new file. The user who creates the file will automatically be assigned to read and write access unless he has passed custom values for read and write arguments.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://appwrite.io/v1/storage/files' \
--form 'file=""'

Response Example

{
    "$id": "string",
    "$permissions": {},
    "dateCreated": 0,
    "mimeType": "string",
    "name": "string",
    "signature": "string",
    "sizeOriginal": 0
}

Request

Body Params multipart/form-data

file

string

required

Binary file.

read

array[string]

optional

An array of strings with read permissions. By default only the current user is granted with read permissions. learn more about permissions and get a full list of available permissions.

write

array[string]

optional

An array of strings with write permissions. By default only the current user is granted with write permissions. learn more about permissions and get a full list of available permissions.

Responses

🟢201File

application/json

Body

File

$id

string

required

File ID.

$permissions

object

required

File permissions.

dateCreated

integer <int32>

required

File creation date in Unix timestamp.

mimeType

string

required

File mime type.

name

string

required

File name.

signature

string

required

File MD5 signature.

sizeOriginal

integer <int32>

required

File original size in bytes.

Modified at 2023-08-16 07:28:13

List Files

Delete File