> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smartbills.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Métadonnées

> Attacher des données personnalisées aux objets Smartbills

Les objets Smartbills modifiables (reçus, clients, produits, dépenses, rapports, etc.) disposent d'un paramètre `metadata` permettant d'attacher des paires clé-valeur. Les métadonnées servent à lier des objets à vos systèmes internes, stocker de la logique métier ou ajouter du contexte spécifique.

Les limitations : maximum 50 clés par objet, noms de clé jusqu'à 40 caractères, valeurs jusqu'à 500 caractères. Les clés et valeurs doivent être des chaînes de caractères. Smartbills n'utilisé pas les métadonnées en interne — elles sont à votre disposition exclusivement.

N'enregistrez jamais d'informations sensibles (mots de passe, clés API, numéros d'identification) dans les métadonnées. Ajoutez les métadonnées lors de la création ou de la mise à jour d'un objet via les requêtes POST ou PATCH.