DocumentazioneRiferimento API
Piano d'azione
Il piano d'azione di un sito: elencare, aggiungere, modificare ed eliminare le sue attività.
Ogni operazione qui sotto è anche uno strumento MCP, con lo stesso nome. Le operazioni Gratis non costano nulla; quelle A pagamento usano i crediti dello spazio di lavoro, come nell'app (Quanto costa).
| Operazione | Chiamata | |
|---|---|---|
| Elenca le attività | GET /sites/{siteId}/todos | Gratis |
| Crea un'attività | POST /sites/{siteId}/todos | Gratis |
| Modifica un'attività | PATCH /sites/{siteId}/todos/{todoId} | Gratis |
| Elimina un'attività | DELETE /sites/{siteId}/todos/{todoId} | Gratis |
Elenca le attività
/sites/{siteId}/todosGratisIl piano d'azione del sito.
Strumento MCP list_todos
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
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"
}
]
}Crea un'attività
/sites/{siteId}/todosGratisAggiungi un'attività al piano d'azione del sito.
- Aggiunta come attività manuale (source manuel), da fare (status a_faire). Risponde con l'attività.
Strumento MCP create_todo
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
titleobbligatorio | string | Cosa fare.1–500 caratteri |
descriptionfacoltativo | string | fino a 4000 caratteri |
priorityfacoltativo | string | high, medium (predefinito) o low.high | medium | low |
categoryfacoltativo | string | Il pilastro del piano a cui appartiene. Predefinito: technical.technical | content | accessibility | backlinks | competitors |
source_langfacoltativo | string | La lingua in cui è scritto il testo (per es. "fr", "en"). Se omesso: la lingua dei contenuti del sito.2–5 caratteri |
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"
}
}Modifica un'attività
/sites/{siteId}/todos/{todoId}GratisModifica un'attività del piano d'azione: il suo stato (da fare, in corso, fatta, ignorata), il titolo, la descrizione o la priorità.
- Risponde con l'attività com'è adesso.
- Il testo viene restituito così com'è salvato, nella lingua in cui è stato scritto (source_lang; null = la lingua dei contenuti del sito). L'app lo traduce quando lo mostra; l'API no.
Strumento MCP update_todo
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
todoIdnel percorso | string | Il suo id. |
statusfacoltativo | string | a_faire (da fare), en_cours (in corso), fait (fatta) o ignore (ignorata).a_faire | en_cours | fait | ignore |
titlefacoltativo | string | 1–500 caratteri |
descriptionfacoltativo | string | null | |
priorityfacoltativo | string | high | medium | low |
source_langfacoltativo | string | La lingua del nuovo titolo / della nuova descrizione. Ignorato se nessuno dei due cambia.2–5 caratteri |
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"}'Risponde 200 con { "data": … }.
Elimina un'attività
/sites/{siteId}/todos/{todoId}GratisRimuovi un'attività dal piano d'azione.
Strumento MCP delete_todo
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
todoIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
-H "Authorization: Bearer sk_live_…"Risponde 204 con { "data": … }.
Hai una domanda a cui qui non trovi risposta? Scrivici.

