Aurabase Logo
aurabasedocs
API/Storage/Uploader un objet

Uploader un objet

POST/v1/storage/{project_id}/{bucket}

Upload multipart d'un fichier dans un bucket. Le chemin de l'objet n'est pas dans l'URL : il est composé du champ path et du nom de fichier de la partie multipart.

#
Request

En-têtes

apikeyREQUIS
Clé API du projet — anon est REFUSÉ en écriture
Authorization
Bearer <JWT utilisateur> — l'utilisateur devient propriétaire de l'objet
Content-TypeREQUIS
multipart/form-data (généré par le client HTTP)
#
Request

Parties multipart

bucketstringREQUIS
Nom du bucket, dans le chemin. Le préfixe réservé _derivatives est interdit.
filepart (fichier)REQUIS
Partie multipart contenant le fichier. Son nom de fichier client et son content-type sont conservés.
pathpart (texte)OPTIONNEL
Sous-dossier dans le bucket. La clé finale est {bucket}/{path}/{fichier}.
upsertpart (texte)OPTIONNEL
true ou 1 pour remplacer un objet existant. Toute autre valeur vaut faux.
meta[clé]part (texte)OPTIONNEL
Métadonnées libres attachées à l'objet.
#
Notes

Limites

Info
La taille maximale est résolue dans cet ordre : limite du bucket, puis limite du projet, puis la configuration du service. Un Content-Length manifestement au-delà est rejeté avant même la lecture du corps. Certaines extensions sont bloquées quoi qu'il arrive.
#
Notes

Gros fichiers

Astuce
Pour les gros fichiers, l'API est un multipart en trois temps : POST …/{bucket}/multipart/init, puis PUT …/{bucket}/multipart/part pour chaque part, puis POST …/{project_id}/multipart/complete (ce dernier n'a pas de segment bucket). DELETE …/{bucket}/multipart abandonne l'upload. Il n'y a pas d'API tus.
v1.0 · révisé 15 avr. 2026