DocumentationRéférence de l'API

Conversations

Les conversations de l'espace ou d'un site, leurs messages, et l'envoi d'un message.

Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).

OpérationAppel
Modifier une conversationPATCH /conversations/{cid}Gratuit
Supprimer une conversationDELETE /conversations/{cid}Gratuit
Lister les conversationsGET /conversationsGratuit
Créer une conversationPOST /conversationsGratuit
Récupérer une conversationGET /conversations/{cid}Gratuit
Lister les messagesGET /conversations/{cid}/messagesGratuit
Envoyer un messagePOST /conversations/{cid}/messagesFacturé
Lister les documents d'une conversationGET /conversations/{cid}/documentsGratuit
Lister les conversations du siteGET /sites/{siteId}/conversationsGratuit
Créer une conversation dans un sitePOST /sites/{siteId}/conversationsGratuit
Récupérer une conversation du siteGET /sites/{siteId}/conversations/{cid}Gratuit
Lister les messages d'une conversation du siteGET /sites/{siteId}/conversations/{cid}/messagesGratuit
Envoyer un message dans un sitePOST /sites/{siteId}/conversations/{cid}/messagesFacturé

Modifier une conversation

PATCH/conversations/{cid}Gratuit

Renommer une conversation, ou la mettre en favori / l'en retirer.

  • Agit sur n'importe quelle conversation de l'espace, y compris celles d'un site (son cid suffit), comme le fait l'app.
  • Seuls les champs fournis changent. Renvoie la conversation.

Outil MCP update_conversation

ArgumentTypeDescription
ciddans le cheminstringSon identifiant.
titlefacultatifstringRenommer la conversation.1–500 caractères
starredfacultatifbooleantrue la met en favori (starred_at = maintenant), false l'en retire.
Requête
curl -X PATCH https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'

Répond 200 avec { "data": … }.

Supprimer une conversation

DELETE/conversations/{cid}Gratuit

Supprimer une conversation.

  • Agit sur n'importe quelle conversation de l'espace, y compris celles d'un site (son cid suffit), comme le fait l'app.
  • Suppression douce, comme dans l'app : elle quitte les listes et répond 404 ; ses messages et les données enregistrées depuis elle sont conservés.

Outil MCP delete_conversation

ArgumentTypeDescription
ciddans le cheminstringSon identifiant.
Requête
curl -X DELETE https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Lister les conversations

GET/conversationsGratuit

Les conversations de l'espace (non rattachées à un site).

Outil MCP list_conversations

Requête
curl https://app.semchat.io/api/v1/conversations \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": [
    {
      "id": "01a163c9-4920-773f-89fb-75ff608e07fe",
      "title": "Audit complet d'alpha",
      "site_id": null,
      "message_count": 2,
      "starred_at": "2026-10-22T13:31:58.000Z",
      "last_message_at": "2026-10-22T13:26:58.000Z",
      "created_at": "2026-10-22T13:24:58.000Z",
      "updated_at": "2026-10-22T13:26:58.000Z"
    },
    {
      "id": "01a15ea2-ed20-7a5d-a415-afcd68358a91",
      "title": "Idées de contenu",
      "site_id": null,
      "message_count": 2,
      "starred_at": "2026-10-21T13:31:58.000Z",
      "last_message_at": "2026-10-21T13:26:58.000Z",
      "created_at": "2026-10-21T13:24:58.000Z",
      "updated_at": "2026-10-21T13:26:58.000Z"
    }
  ]
}

Créer une conversation

POST/conversationsGratuit

Démarrer une conversation dans l'espace.

Outil MCP create_conversation

ArgumentTypeDescription
titlefacultatifstringSon titre (facultatif).jusqu'à 500 caractères
Requête
curl -X POST https://app.semchat.io/api/v1/conversations \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'

Répond 201 avec { "data": … }.

Récupérer une conversation

GET/conversations/{cid}Gratuit

Une conversation de l'espace (celles des sites comprises).

Outil MCP get_conversation

ArgumentTypeDescription
ciddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": {
    "id": "01a163c9-4920-773f-89fb-75ff608e07fe",
    "title": "Audit complet d'alpha",
    "site_id": null,
    "message_count": 2,
    "starred_at": "2026-10-22T13:31:58.000Z",
    "last_message_at": "2026-10-22T13:26:58.000Z",
    "created_at": "2026-10-22T13:24:58.000Z",
    "updated_at": "2026-10-22T13:26:58.000Z"
  }
}

Lister les messages

GET/conversations/{cid}/messagesGratuit

Les messages d'une conversation de l'espace, du plus ancien au plus récent (texte, appels d'outils et leurs résultats, graphiques, documents).

Outil MCP list_messages

ArgumentTypeDescription
ciddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": [
    {
      "id": "01a15456-3520-7803-9dfd-670569df332f",
      "role": "user",
      "content": "C'est quoi le SEO ?",
      "parts": [
        "…"
      ],
      "created_at": "2026-10-19T13:24:58.272Z"
    },
    {
      "id": "01a15456-aa50-78f0-8c72-120a580ca098",
      "role": "assistant",
      "content": "Le référencement naturel.",
      "parts": [
        "…",
        "…"
      ],
      "created_at": "2026-10-19T13:25:28.272Z"
    }
  ]
}

Envoyer un message

POST/conversations/{cid}/messagesFacturé

Envoyer un message : l'assistant répond en utilisant ses outils (données de mots-clés, exploration, concurrents…) comme dans l'app.

  • Les pièces jointes sont enregistrées comme dans l'app (tout membre de l'espace ; un type non pris en charge ou un fichier de plus de 20 Mo donne INVALID_INPUT) et parviennent à l'assistant avec le message. Une requête fait 25 Mo au plus : environ 18 Mo de fichiers une fois encodés en base64.
  • L'API envoie la réponse en flux, en Server-Sent Events (« UI message stream » du Vercel AI SDK) ; une fois terminée, lisez-la en entier avec la liste des messages. Via MCP, l'outil attend la fin et renvoie la réponse.
  • Facturé en crédits exactement comme un tour de chat dans l'app.

Outil MCP send_message

ArgumentTypeDescription
ciddans le cheminstringSon identifiant.
messageobligatoirestringLe message de l'utilisateur.au moins 1 caractère
attachmentsfacultatifarrayLes fichiers joints au message, comme dans l'app (les mêmes types, 20 Mo chacun au plus).
streamfacultatifbooleanAccepté pour compatibilité ; la réponse de l'API arrive toujours en flux.
Requête
curl -X POST https://app.semchat.io/api/v1/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"message": "…"}'

La réponse arrive en flux (Server-Sent Events) ; une fois terminée, lisez-la en entier avec la liste des messages. Via MCP, l'outil attend la fin et renvoie la réponse.

Lister les documents d'une conversation

GET/conversations/{cid}/documentsGratuit

Les documents écrits dans une conversation de l'espace.

Outil MCP list_conversation_documents

ArgumentTypeDescription
ciddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/conversations/{cid}/documents \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Lister les conversations du site

GET/sites/{siteId}/conversationsGratuit

Les conversations d'un site.

Outil MCP list_site_conversations

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Créer une conversation dans un site

POST/sites/{siteId}/conversationsGratuit

Démarrer une conversation sur un site : l'assistant connaît ce site.

Outil MCP create_site_conversation

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
titlefacultatifstringSon titre (facultatif).jusqu'à 500 caractères
Requête
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'

Répond 201 avec { "data": … }.

Récupérer une conversation du site

GET/sites/{siteId}/conversations/{cid}Gratuit

L'une des conversations d'un site.

Outil MCP get_site_conversation

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
ciddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Lister les messages d'une conversation du site

GET/sites/{siteId}/conversations/{cid}/messagesGratuit

Les messages d'une conversation de site, du plus ancien au plus récent.

Outil MCP list_site_messages

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
ciddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Envoyer un message dans un site

POST/sites/{siteId}/conversations/{cid}/messagesFacturé

Envoyer un message dans une conversation de site : l'assistant répond en gardant ce site en tête.

  • Les pièces jointes sont enregistrées comme dans l'app (tout membre de l'espace ; un type non pris en charge ou un fichier de plus de 20 Mo donne INVALID_INPUT) et parviennent à l'assistant avec le message. Une requête fait 25 Mo au plus : environ 18 Mo de fichiers une fois encodés en base64.
  • L'API envoie la réponse en flux, en Server-Sent Events (« UI message stream » du Vercel AI SDK) ; une fois terminée, lisez-la en entier avec la liste des messages. Via MCP, l'outil attend la fin et renvoie la réponse.
  • Facturé en crédits exactement comme un tour de chat dans l'app.

Outil MCP send_site_message

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
ciddans le cheminstringSon identifiant.
messageobligatoirestringLe message de l'utilisateur.au moins 1 caractère
attachmentsfacultatifarrayLes fichiers joints au message, comme dans l'app (les mêmes types, 20 Mo chacun au plus).
streamfacultatifbooleanAccepté pour compatibilité ; la réponse de l'API arrive toujours en flux.
Requête
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"message": "…"}'

La réponse arrive en flux (Server-Sent Events) ; une fois terminée, lisez-la en entier avec la liste des messages. Via MCP, l'outil attend la fin et renvoie la réponse.

Une question sans réponse ici ? Écrivez-nous.

Prêt à faire décoller votre site ?

Posez votre première question - semchat vous répond avec un plan d'action clair, en quelques secondes.

Gratuit · sans inscription · en 5 secondes