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

# Créer un dossier

> Créez un dossier pour organiser vos assistants

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Crée un dossier pour regrouper vos assistants. Affectez des assistants à un dossier avec le champ `folder_id` sur les points de terminaison [Créer un assistant](/fr/api-v1/assistants/create) et [Mettre à jour un assistant](/fr/api-v1/assistants/update).

### Corps de la requête

<ParamField body="name" type="string" required>
  Le nom du dossier (255 caractères max). Doit être unique au sein de votre compte.
</ParamField>

<ParamField body="color" type="string">
  Une couleur pour le badge du dossier. L'une des valeurs suivantes : `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.
</ParamField>

### Réponse

<ResponseField name="message" type="string">Message de succès</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="propriétés">
    <ResponseField name="id" type="integer">L'identifiant unique du dossier créé</ResponseField>
    <ResponseField name="name" type="string">Le nom du dossier</ResponseField>
    <ResponseField name="color" type="string">La couleur du dossier (ou `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Nombre d'assistants dans ce dossier (toujours `0` pour un nouveau dossier)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Success Response theme={null} theme={null}
  {
    "message": "Folder created successfully",
    "data": { "id": 12, "name": "Acme Corp", "color": "blue", "assistants_count": 0 }
  }
  ```

  ```json 422 Validation Error theme={null} theme={null}
  {
    "message": "The name has already been taken.",
    "errors": { "name": ["The name has already been taken."] }
  }
  ```
</ResponseExample>