DocumentationRéférence de l'API

Plan d'action

Le plan d'action d'un site : lister, ajouter, modifier et supprimer ses tâches.

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
Lister le plan d'actionGET /sites/{siteId}/todosGratuit
Ajouter une tâchePOST /sites/{siteId}/todosGratuit
Modifier une tâchePATCH /sites/{siteId}/todos/{todoId}Gratuit
Supprimer une tâcheDELETE /sites/{siteId}/todos/{todoId}Gratuit

Lister le plan d'action

GET/sites/{siteId}/todosGratuit

Le plan d'action du site.

Outil MCP list_todos

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7c64-bc14-c499bd6f1b83",
      "title": "Corriger le point technical n°1",
      "description": "Corriger le point technical n°1 - détail.",
      "category": "technical",
      "priority": "high",
      "status": "a_faire",
      "source": "audit_auto",
      "created_at": "2026-10-21T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-74b9-8ca0-f4c3410b0f0f",
      "title": "Corriger le point technical n°2",
      "description": "Corriger le point technical n°2 - détail.",
      "category": "technical",
      "priority": "medium",
      "status": "fait",
      "source": "audit_auto",
      "created_at": "2026-10-21T13:27:58.000Z"
    }
  ]
}

Ajouter une tâche

POST/sites/{siteId}/todosGratuit

Ajouter une tâche au plan d'action du site.

  • Ajoutée comme tâche manuelle (source manuel), à faire (status a_faire). Renvoie la tâche.

Outil MCP create_todo

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
titleobligatoirestringCe qu'il faut faire.1–500 caractères
descriptionfacultatifstringjusqu'à 4000 caractères
priorityfacultatifstringhigh, medium (par défaut) ou low.high | medium | low
categoryfacultatifstringLe pilier du plan auquel elle appartient. Par défaut technical.technical | content | accessibility | backlinks | competitors
source_langfacultatifstringLa langue dans laquelle le texte est écrit (par ex. "fr", "en"). Omise : la langue du contenu du site.2–5 caractères
Requête
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'
Réponse · 201
{
  "data": {
    "id": "01a168f1-9dac-7584-b809-fc4ed6d1cffe",
    "title": "Add alt text to the gallery images",
    "description": null,
    "category": "technical",
    "priority": "high",
    "status": "a_faire",
    "source": "manuel",
    "created_at": "2026-10-23T13:27:07.000Z"
  }
}

Modifier une tâche

PATCH/sites/{siteId}/todos/{todoId}Gratuit

Modifier une tâche du plan d'action : son statut (à faire, en cours, fait, ignoré), son titre, sa description ou sa priorité.

  • Renvoie la tâche telle qu'elle est désormais.
  • Le texte est renvoyé tel qu'il est enregistré, dans la langue où il a été écrit (source_lang ; null = la langue du contenu du site). L'app le traduit à l'affichage ; l'API non.

Outil MCP update_todo

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
todoIddans le cheminstringSon identifiant.
statusfacultatifstringa_faire (à faire), en_cours (en cours), fait (fait) ou ignore (ignoré).a_faire | en_cours | fait | ignore
titlefacultatifstring1–500 caractères
descriptionfacultatifstring | null
priorityfacultatifstringhigh | medium | low
source_langfacultatifstringLa langue du nouveau titre / de la nouvelle description. Ignorée quand aucun des deux ne change.2–5 caractères
Requête
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"status": "a_faire"}'

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

Supprimer une tâche

DELETE/sites/{siteId}/todos/{todoId}Gratuit

Retirer une tâche du plan d'action.

Outil MCP delete_todo

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

Répond 204 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