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

# Modèles

> Liste, récupère, mets à jour et supprime les modèles de ton organisation.

Gère le catalogue de modèles de ton organisation. Ces endpoints lisent et modifient les modèles qui
existent déjà — pour en créer un, voir
[Entraînement de modèles](/fr/api-reference/model-training/overview).

* [`GET /models`](/fr/api-reference/models/list) — liste les modèles de ton organisation,
  les plus récents d'abord ; filtre par `category` et/ou `status`, pagine avec
  `limit`/`offset`.
* [`GET /models/{id}`](/fr/api-reference/models/get) — détail complet d'un modèle,
  y compris les presigned URLs des images de référence, le prompt par défaut et les trigger words.
* [`PATCH /models/{id}`](/fr/api-reference/models/update) — met à jour les champs modifiables
  (`name`, `default_prompt`).
* [`DELETE /models/{id}`](/fr/api-reference/models/delete) — supprime en douceur (soft-delete) un modèle pour qu'il
  cesse d'apparaître dans l'app et l'API.

Les lectures nécessitent le scope `models.read` ; `PATCH` et `DELETE` nécessitent `models.write`.
Les champs de propriété et de confidentialité ne peuvent pas être modifiés, et un id appartenant à une autre
organisation renvoie [`404 not_found`](/fr/guides/errors#not_found).