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

# Publier un message

> Envoyez un nouveau message à un chat existant pour continuer la conversation

Envoie un nouveau message à un chat existant, poursuivant la conversation.

## Requête

```
POST /api/chat/{chatId}/publish
```

### En-têtes

| En-tête | Requis | Description |
| - | - | - |
| `Authorization` | Oui | `Bearer macaly_...` |
| `Content-Type` | Oui | `application/json` |

### Paramètres de chemin

| Paramètre | Type | Description |
| - | - | - |
| `chatId` | string | L'ID du chat |

### Paramètres du corps

| Champ | Type | Requis | Défaut | Description |
| - | - | - | - | - |
| `content` | string | Conditionnel | - | Le message de l'utilisateur. Requis sauf si `resume` est `true` |
| `stream` | boolean | Non | `true` | Si `false`, retourne du JSON au lieu d'un stream |
| `agentMode` | `"auto"` \| `"fast"` \| `"smart"` | Non | `"auto"` | Contrôle le compromis vitesse/qualité de l'agent IA |
| `executionMode` | `"auto"` \| `"planning"` \| `"build"` | Non | `"auto"` | Contrôle l'approche de l'IA pour la tâche |
| `model` | `"gpt-5.6-terra"` \| `"gpt-6.1-sol"` \| `"gpt-6-luna"` \| `"grok-4-6"` \| `"kimi-k3"` \| `"sonnet-5-5"` \| `"opus-5-5"` \| `"blueai-glm-5-3"` \| `"blueai-glm-5-3-flash"` | Non | - | Modèle IA à utiliser. Par défaut, le modèle configuré pour l'équipe |
| `reasoningEffort` | `"medium"` \| `"high"` | Non | - | Contrôle la profondeur de raisonnement de l'IA |
| `resume` | boolean | Non | `false` | Si `true`, reprend une conversation arrêtée sans ajouter de nouveau contenu |
| `experimental_attachments` | array | Non | `[]` | Pièces jointes (voir [Créer un chat](/docs/fr/api/create-chat) pour le format) |

<Note>
  Quand `resume` est `true`, vous ne pouvez pas inclure `content` ni `experimental_attachments`. Ceci sert à reprendre une conversation qui a été précédemment arrêtée.
</Note>

### Exemple de requête

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://www.macaly.com/api/chat/abc123def456/publish" \
    -H "Authorization: Bearer macaly_abc123..." \
    -H "Content-Type: application/json" \
    -d '{
      "content": "Add a dark mode toggle to the header",
      "stream": false
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    `https://www.macaly.com/api/chat/${chatId}/publish`,
    {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer macaly_abc123...',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        content: 'Add a dark mode toggle to the header',
        stream: false,
      }),
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      f'https://www.macaly.com/api/chat/{chat_id}/publish',
      headers={
          'Authorization': 'Bearer macaly_abc123...',
          'Content-Type': 'application/json',
      },
      json={
          'content': 'Add a dark mode toggle to the header',
          'stream': False,
      },
  )

  data = response.json()
  ```
</CodeGroup>

## Réponse

### Réponse JSON (quand `stream: false`)

```json theme={null}
{
  "chatId": "abc123def456",
  "streamId": "stream_xyz789",
  "assistantMessageId": "msg_123"
}
```

Vous pouvez ensuite interroger l'endpoint [Obtenir le statut](/docs/fr/api/get-status) pour attendre la fin du traitement.

### Réponse streaming (quand `stream: true`, par défaut)

```
2:[{"chatId":"abc123def456"}]
0:"Analyzing your request..."
...
```

## Codes de statut

| Statut | Description |
| - | - |
| 200 | Succès - Message envoyé |
| 400 | Corps de requête invalide |
| 401 | Clé API invalide ou manquante |
| 402 | Crédits insuffisants |
| 403 | Le chat n'appartient pas à cette équipe |
| 404 | Chat introuvable |
| 429 | Limite de requêtes atteinte |
| 500 | Erreur serveur |
| 503 | Service indisponible - L'espace de travail IA est occupé, réessayez dans un instant |

## Workflow

Pour une utilisation sans streaming, le workflow typique est :

1. **Envoyez un message** avec `stream: false`
2. **Interrogez le statut** avec [`GET /api/chat/{chatId}/status`](/docs/fr/api/get-status) jusqu'à `completed`
3. **Répétez** pour les messages suivants


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.