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ération | Appel | |
|---|---|---|
| Lister le plan d'action | GET /sites/{siteId}/todos | Gratuit |
| Ajouter une tâche | POST /sites/{siteId}/todos | Gratuit |
| Modifier une tâche | PATCH /sites/{siteId}/todos/{todoId} | Gratuit |
| Supprimer une tâche | DELETE /sites/{siteId}/todos/{todoId} | Gratuit |
Lister le plan d'action
/sites/{siteId}/todosGratuitLe plan d'action du site.
Outil MCP list_todos
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/todosGratuitAjouter 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
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
titleobligatoire | string | Ce qu'il faut faire.1–500 caractères |
descriptionfacultatif | string | jusqu'à 4000 caractères |
priorityfacultatif | string | high, medium (par défaut) ou low.high | medium | low |
categoryfacultatif | string | Le pilier du plan auquel elle appartient. Par défaut technical.technical | content | accessibility | backlinks | competitors |
source_langfacultatif | string | La langue dans laquelle le texte est écrit (par ex. "fr", "en"). Omise : la langue du contenu du site.2–5 caractères |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'{
"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
/sites/{siteId}/todos/{todoId}GratuitModifier 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
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
todoIddans le chemin | string | Son identifiant. |
statusfacultatif | string | a_faire (à faire), en_cours (en cours), fait (fait) ou ignore (ignoré).a_faire | en_cours | fait | ignore |
titlefacultatif | string | 1–500 caractères |
descriptionfacultatif | string | null | |
priorityfacultatif | string | high | medium | low |
source_langfacultatif | string | La langue du nouveau titre / de la nouvelle description. Ignorée quand aucun des deux ne change.2–5 caractères |
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
/sites/{siteId}/todos/{todoId}GratuitRetirer une tâche du plan d'action.
Outil MCP delete_todo
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
todoIddans le chemin | string | Son identifiant. |
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.

