DocumentationRéférence de l'API
Espace de travail
L'espace de travail, son usage, la recherche, les compétences, les préférences d'outils et les connecteurs.
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ération | Appel | |
|---|---|---|
| Récupérer l'espace | GET /workspace | Gratuit |
| Récupérer l'usage | GET /usage | Gratuit |
| Lister les compétences | GET /skills | Gratuit |
| Lister les connecteurs | GET /connectors | Gratuit |
| Rechercher dans l'espace | POST /search | Gratuit |
| Modifier l'espace | PATCH /workspace | Gratuit |
| Activer ou désactiver une compétence | PATCH /skills/{skillId} | Gratuit |
| Lister les préférences d'outils | GET /workspace/tools | Gratuit |
| Lister les préférences d'outils d'un site | GET /sites/{siteId}/tools | Gratuit |
| Régler un outil | PATCH /workspace/tools | Gratuit |
| Déconnecter un connecteur | DELETE /connectors/{provider} | Gratuit |
| Déconnecter un connecteur du site | DELETE /sites/{siteId}/connectors/{provider} | Gratuit |
Récupérer l'espace
/workspaceGratuitL'espace de travail, son plan et la part des crédits de la période déjà utilisée.
- Les crédits ne s'affichent jamais en nombres bruts : seulement en pourcentage de la période.
Outil MCP get_workspace
curl https://app.semchat.io/api/v1/workspace \
-H "Authorization: Bearer sk_live_…"{
"data": {
"id": "01995d03-8ea0-79ee-8ee3-c2eed260b3bc",
"name": "Acme",
"plan": {
"id": "starter",
"name": "Starter",
"features": {
"gsc": true,
"market_data": true,
"agents": 11,
"backlinks": true,
"weekly_reports": true,
"ai_writer": true
}
},
"balance": {
"used_pct": 12.5,
"remaining_pct": 87.5,
"period_resets_at": "2026-11-12T13:26:58.000Z"
},
"settings": {
"description": null,
"custom_instructions": "Nous sommes une agence SEO lyonnaise.",
"company_name": null,
"company_website": null,
"company_siren": null,
"company_address": null
}
}
}Récupérer l'usage
/usageGratuitL'usage de la période en cours, en pourcentage, réparti par catégorie.
Outil MCP get_usage
curl https://app.semchat.io/api/v1/usage \
-H "Authorization: Bearer sk_live_…"{
"data": {
"period": "current",
"used_pct": 12.5,
"remaining_pct": 87.5,
"by_category_pct": {
"conversations": 2.5,
"seo_tools": 2.5,
"visuals": 2.5,
"documents": 2.5,
"site_analysis": 2.5
}
}
}Lister les compétences
/skillsGratuitLes compétences disponibles pour le chat de l'espace.
Outil MCP list_skills
curl https://app.semchat.io/api/v1/skills \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "cocon-semantique",
"name": "Topic cluster",
"when_to_use": "Quand l'utilisateur demande : cocon sémantique.",
"enabled": true
},
{
"id": "seo-audit",
"name": "SEO audit",
"when_to_use": "Quand l'utilisateur demande : audit seo.",
"enabled": true
}
]
}Lister les connecteurs
/connectorsGratuitLes outils connectés au niveau de l'espace (Search Console, GA4, Slack, Notion…).
- La plupart des connexions se font par site : voir list_site_connectors.
Outil MCP list_connectors
curl https://app.semchat.io/api/v1/connectors \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Rechercher dans l'espace
/searchGratuitCherche dans les conversations, les sites, les tâches planifiées, les connecteurs et les compétences de l'espace, par nom, adresse, message ou compte, comme la recherche de l'app (⌘K).
- Chaque type arrive avec
more, à true quand il en existe d'autres que ceux renvoyés. - Les conversations sont cherchées par leur titre.
Outil MCP search_workspace
| Argument | Type | Description |
|---|---|---|
queryobligatoire | string | Ce qu'il faut chercher, sans tenir compte des accents ni des majuscules. Vide : les plus récents de chaque type.jusqu'à 100 caractères |
limitfacultatif | integer | Au plus ce nombre par type (50 par défaut et au maximum).≥ 1, ≤ 50 |
curl -X POST https://app.semchat.io/api/v1/search \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"query": "…"}'Répond 200 avec { "data": … }.
Modifier l'espace
/workspaceGratuitModifier les réglages de l'espace : son nom, sa description, les instructions personnalisées pour l'assistant, les informations de l'entreprise.
- Propriétaire ou administrateur uniquement (le rôle du créateur de la clé) : 403 FORBIDDEN sinon.
- Seuls les champs fournis changent ; un texte vide (ou null) efface un champ. Au moins un champ est requis.
Outil MCP update_workspace
| Argument | Type | Description |
|---|---|---|
namefacultatif | string | 1–255 caractères |
descriptionfacultatif | string | null | |
custom_instructionsfacultatif | string | null | Les instructions que l'assistant suit dans chaque conversation de l'espace. |
company_namefacultatif | string | null | |
company_websitefacultatif | string | null | |
company_sirenfacultatif | string | null | Le numéro d'immatriculation de l'entreprise. |
company_addressfacultatif | string | null |
curl -X PATCH https://app.semchat.io/api/v1/workspace \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Répond 200 avec { "data": … }.
Activer ou désactiver une compétence
/skills/{skillId}GratuitActiver ou désactiver l'une des compétences de l'espace pour son chat.
- Propriétaire ou administrateur uniquement (le rôle du créateur de la clé) : 403 FORBIDDEN sinon.
Outil MCP set_skill
| Argument | Type | Description |
|---|---|---|
skillIddans le chemin | string | Son identifiant. |
enabledobligatoire | boolean |
curl -X PATCH https://app.semchat.io/api/v1/skills/{skillId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"enabled": true}'Répond 200 avec { "data": … }.
Lister les préférences d'outils
/workspace/toolsGratuitLes outils des connecteurs que l'assistant peut utiliser, chacun activé ou désactivé pour l'espace.
- Un outil est activé sauf s'il a été désactivé. Chaque site hérite de ces choix, sauf s'il fixe les siens : voir list_site_tool_prefs.
Outil MCP list_tool_prefs
curl https://app.semchat.io/api/v1/workspace/tools \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Lister les préférences d'outils d'un site
/sites/{siteId}/toolsGratuitLes outils des connecteurs que l'assistant peut utiliser dans les conversations de ce site, chacun activé ou désactivé.
- Le choix propre au site s'il en a fait un, sinon celui de l'espace.
Outil MCP list_site_tool_prefs
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/tools \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Régler un outil
/workspace/toolsGratuitActiver ou désactiver un outil pour l'assistant, pour l'espace ou pour un seul site.
Outil MCP set_tool_pref
| Argument | Type | Description |
|---|---|---|
tool_nameobligatoire | string | L'outil, tel que list_tool_prefs le nomme.1–64 caractères |
enabledobligatoire | boolean | |
site_idfacultatif | string | Pour ce site seulement (par défaut : l'espace).au moins 1 caractère |
curl -X PATCH https://app.semchat.io/api/v1/workspace/tools \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"tool_name": "…", "enabled": true}'Répond 200 avec { "data": … }.
Déconnecter un connecteur
/connectors/{provider}GratuitDéconnecter un outil connecté au niveau de l'espace (son accès enregistré est supprimé).
- provider tel que list_connectors l'affiche (google_search_console, google_analytics_4, notion, slack, wordpress, webflow, microsoft_clarity, bing_webmaster_tools, yandex_metrica).
- Les connexions propres aux sites ne sont pas touchées : voir disconnect_site_connector. Un outil se connecte dans l'app.
Outil MCP disconnect_connector
| Argument | Type | Description |
|---|---|---|
providerdans le chemin | string | Son identifiant. |
curl -X DELETE https://app.semchat.io/api/v1/connectors/{provider} \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Déconnecter un connecteur du site
/sites/{siteId}/connectors/{provider}GratuitDéconnecter un outil connecté à ce site (son accès enregistré est supprimé).
- provider tel que list_site_connectors l'affiche.
Outil MCP disconnect_site_connector
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
providerdans le chemin | string | Son identifiant. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/connectors/{provider} \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Une question sans réponse ici ? Écrivez-nous.

