Guide d'action
Tracke chaque fichier qui arrive dans ton stockage
POST
/v1/events · file.uploadedÉmets un event `file.uploaded` après qu'un fichier soit committé dans ton object storage. Stocke filename, size et mime type pour répondre à 'qui a uploadé ce PDF la semaine dernière'.
Quand l'émettre
Après l'écriture finale dans le stockage (S3, R2, GCS), quand tu assignes son ID interne au fichier.
Payload d'exemple
await recalled.events.create({
action: "file.uploaded",
actor: { id: user.id, email: user.email },
organization: user.organizationId,
metadata: {
filename: "value",
size: "value",
mimeType: "value"
},
});Metadata à inclure
Garde les metadata plates et cohérentes dans ton service pour que recherche et exports CSV fonctionnent bien.
| Clé | Rôle |
|---|---|
filename | Nom du fichier original côté client |
size | Taille en octets |
mimeType | application/pdf, image/png, ... |
storageKey | Clé objet dans ton bucket |
Rétention recommandée
Aligner sur ta politique de rétention de stockage, en général 12 à 24 mois.