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

# Mettre à jour une liste

> Modifiez les métadonnées d’une liste de contacts

### Endpoint

<ParamField method="PUT" path="/v1/contact-groups/:id" />

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token avec votre Secret Key (format: `Bearer sk_...`)
</ParamField>

### URL Parameters

<ParamField path="id" type="string" required>
  L'identifiant de la liste
</ParamField>

### Body Parameters

Tous les paramètres sont optionnels. Seuls les champs fournis seront mis à jour.

| Paramètre | Type   | Description                |
| :-------- | :----- | :------------------------- |
| `name`    | string | Nouveau nom de la liste    |
| `csvUrl`  | string | Nouvelle URL du CSV source |

### Exemples de requêtes

<CodeGroup>
  ```bash BASH theme={null}
  curl -X PUT https://api.wachap.com/v1/contact-groups/65f1234567890abcdef12345 \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer token" \
    -d '{
      "name": "Clients VIP 2024"
    }'
  ```

  ```javascript JAVASCRIPT theme={null}
  const response = await fetch('https://api.wachap.com/v1/contact-groups/65f1234567890abcdef12345', {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer token',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: "Clients VIP 2024"
    })
  });
  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

### Exemple de réponse

```json theme={null}
{
  "success": true,
  "list": {
    "$id": "65f1234567890abcdef12345",
    "userId": "user_xxx",
    "name": "Clients VIP 2024",
    "csvUrl": null,
    "status": "ready",
    "createdAt": "2024-03-15T10:00:00.000Z",
    "updatedAt": "2024-03-16T14:30:00.000Z"
  }
}
```

### Note importante

Cette opération ne modifie que les **métadonnées** de la liste. Les contacts existants ne sont pas affectés.

### Codes d'erreur

| Code  | Description                                                   |
| :---- | :------------------------------------------------------------ |
| `401` | INVALID\_SECRET\_KEY - Clé secrète invalide                   |
| `404` | Liste non trouvée                                             |
| `500` | UPDATE\_CONTACT\_GROUP\_ERROR - Erreur lors de la mise à jour |


## OpenAPI

````yaml PUT /contact-groups/{id}
openapi: 3.0.3
info:
  title: WaChap API
  version: 2.0.0
servers:
  - url: https://api.wachap.com/v1
    description: WaChap API server
security:
  - BearerAuth: []
tags:
  - name: Instances
    description: Créer et gérer des instances WhatsApp
  - name: Webhook
    description: Configuration des webhooks de réception
  - name: Messages
    description: Envoyer des messages WhatsApp
  - name: Comptes
    description: Gérer vos comptes WhatsApp connectés
  - name: SMS
    description: Service SMS de WaChap (V4) via FCM
  - name: Étiquettes WhatsApp
    description: Créer et associer des étiquettes aux conversations WhatsApp
paths:
  /contact-groups/{id}:
    put:
      tags:
        - Listes de contacts
      summary: Mettre à jour une liste
      description: Modifiez les métadonnées d'une liste de contacts.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                csvUrl:
                  type: string
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````