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érationAppel
Récupérer l'espaceGET /workspaceGratuit
Récupérer l'usageGET /usageGratuit
Lister les compétencesGET /skillsGratuit
Lister les connecteursGET /connectorsGratuit
Rechercher dans l'espacePOST /searchGratuit
Modifier l'espacePATCH /workspaceGratuit
Activer ou désactiver une compétencePATCH /skills/{skillId}Gratuit
Lister les préférences d'outilsGET /workspace/toolsGratuit
Lister les préférences d'outils d'un siteGET /sites/{siteId}/toolsGratuit
Régler un outilPATCH /workspace/toolsGratuit
Déconnecter un connecteurDELETE /connectors/{provider}Gratuit
Déconnecter un connecteur du siteDELETE /sites/{siteId}/connectors/{provider}Gratuit

Récupérer l'espace

GET/workspaceGratuit

L'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

Requête
curl https://app.semchat.io/api/v1/workspace \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "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

GET/usageGratuit

L'usage de la période en cours, en pourcentage, réparti par catégorie.

Outil MCP get_usage

Requête
curl https://app.semchat.io/api/v1/usage \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "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

GET/skillsGratuit

Les compétences disponibles pour le chat de l'espace.

Outil MCP list_skills

Requête
curl https://app.semchat.io/api/v1/skills \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "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

GET/connectorsGratuit

Les 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

Requête
curl https://app.semchat.io/api/v1/connectors \
  -H "Authorization: Bearer sk_live_…"

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

Rechercher dans l'espace

POST/searchGratuit

Cherche 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

ArgumentTypeDescription
queryobligatoirestringCe qu'il faut chercher, sans tenir compte des accents ni des majuscules. Vide : les plus récents de chaque type.jusqu'à 100 caractères
limitfacultatifintegerAu plus ce nombre par type (50 par défaut et au maximum).≥ 1, ≤ 50
Requête
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

PATCH/workspaceGratuit

Modifier 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

ArgumentTypeDescription
namefacultatifstring1–255 caractères
descriptionfacultatifstring | null
custom_instructionsfacultatifstring | nullLes instructions que l'assistant suit dans chaque conversation de l'espace.
company_namefacultatifstring | null
company_websitefacultatifstring | null
company_sirenfacultatifstring | nullLe numéro d'immatriculation de l'entreprise.
company_addressfacultatifstring | null
Requête
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

PATCH/skills/{skillId}Gratuit

Activer 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

ArgumentTypeDescription
skillIddans le cheminstringSon identifiant.
enabledobligatoireboolean
Requête
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

GET/workspace/toolsGratuit

Les 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

Requête
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

GET/sites/{siteId}/toolsGratuit

Les 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

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

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

Régler un outil

PATCH/workspace/toolsGratuit

Activer ou désactiver un outil pour l'assistant, pour l'espace ou pour un seul site.

Outil MCP set_tool_pref

ArgumentTypeDescription
tool_nameobligatoirestringL'outil, tel que list_tool_prefs le nomme.1–64 caractères
enabledobligatoireboolean
site_idfacultatifstringPour ce site seulement (par défaut : l'espace).au moins 1 caractère
Requête
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

DELETE/connectors/{provider}Gratuit

Dé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

ArgumentTypeDescription
providerdans le cheminstringSon identifiant.
Requête
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

DELETE/sites/{siteId}/connectors/{provider}Gratuit

Dé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

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
providerdans le cheminstringSon identifiant.
Requête
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.

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