API / Storage / Uploader un objet Uploader un objet POST /storage/v1/object/{bucket}/{path}
Upload d'un fichier dans un bucket. Fichiers > 6 MB automatiquement chunked avec reprise. Scan antivirus ClamAV appliqué en sortie.
bucketstring REQUIS
Nom du bucket cible. Créé au préalable depuis le Studio ou CLI.
pathstring REQUIS
Chemin de l'objet dans le bucket. Format libre, mais convention {user_id}/{filename} recommandée pour les policies RLS.
contentbytes REQUIS
Corps de la requête = bytes du fichier (multipart ou octet-stream).
cacheControlstring OPTIONNEL
Header Cache-Control à appliquer (max-age=31536000, immutable).
upsertboolean OPTIONNEL
True pour remplacer un objet existant sur le même path.
Astuce
Pour les fichiers > 6 MB, utilisez l'API tus via aura.storage.uploadResumable(). Le SDK gère les chunks et la reprise sur coupure réseau automatiquement.
v1.0 · révisé 15 avr. 2026
Node cURL
REQUEST · upload.ts
TYPESCRIPT copy
const { data } = await aura. storage . from ( 'avatars' )
. upload ( `${user.id}/avatar.png` , file, {
upsert : true ,
cacheControl : 'max-age=86400' ,
})
200 413
RESPONSE · 200.json
JSON copy
{ "path" : "u_.../avatar.png" , "size" : 24578 , "etag" : "\"abc...\"" }
