API/Database/Insérer des lignes Insérer des lignes
POST/rest/v1/{table}
Insère un ou plusieurs enregistrements dans une table du schéma projet. Supporte l'upsert via on_conflict et retourne les lignes créées par défaut.
AuthorizationREQUIS
Bearer <ANON_KEY> | Bearer <SERVICE_ROLE_KEY>apikeyREQUIS
Votre PROJECT_API_KEYContent-TypeREQUIS
application/jsonPrefer
return=representation (défaut) | return=minimaltablestringREQUIS
Nom de la table cible dans le schéma du projet.
columnsstringOPTIONNEL
Liste des colonnes à retourner après insertion. Défaut : toutes.
returningenumOPTIONNEL
"representation" (défaut) · "minimal" · "headers-only".
valuesobject | object[]REQUIS
Enregistrement à insérer, ou tableau pour insertion en lot.
↳ Propriétés
iduuid
Défaut : gen_random_uuid(). Omettre pour génération serveur.
created_attimestamptz
Défaut : now(). Omettre pour horodatage serveur.
[key]any
Toute colonne déclarée par votre schéma.
on_conflictstringOPTIONNEL
Colonne(s) de contrainte pour upsert : ex. id ou email,tenant_id.
201CreatedRessource(s) créée(s). Body = representation par défaut.
400Bad RequestSchéma invalide ou colonne inconnue. Voir champ `details`.
409ConflictViolation de contrainte unique sans on_conflict.
413Payload Too LargeBatch > 10 000 lignes. Diviser en plusieurs requêtes.
Info
Le header Prefer: return=representation est ajouté automatiquement par le SDK. Ajoutez Prefer: return=minimal pour alléger la réponse.
Attention
Les insertions en lot sont atomiques : si une ligne viole une contrainte, toutes sont annulées.
v1.0 · révisé 15 avr. 2026
