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).

OperazioneChiamata
Elenca le attivitàGET /sites/{siteId}/todosGratis
Crea un'attivitàPOST /sites/{siteId}/todosGratis
Modifica un'attivitàPATCH /sites/{siteId}/todos/{todoId}Gratis
Elimina un'attivitàDELETE /sites/{siteId}/todos/{todoId}Gratis

Elenca le attività

GET/sites/{siteId}/todosGratis

Il piano d'azione del sito.

Strumento MCP list_todos

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…"
Risposta · 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"
    }
  ]
}

Crea un'attività

POST/sites/{siteId}/todosGratis

Aggiungi 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
titleobbligatoriostringCosa fare.1–500 caratteri
descriptionfacoltativostringfino a 4000 caratteri
priorityfacoltativostringhigh, medium (predefinito) o low.high | medium | low
categoryfacoltativostringIl pilastro del piano a cui appartiene. Predefinito: technical.technical | content | accessibility | backlinks | competitors
source_langfacoltativostringLa lingua in cui è scritto il testo (per es. "fr", "en"). Se omesso: la lingua dei contenuti del sito.2–5 caratteri
Richiesta
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'
Risposta · 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"
  }
}

Modifica un'attività

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

Modifica 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
todoIdnel percorsostringIl suo id.
statusfacoltativostringa_faire (da fare), en_cours (in corso), fait (fatta) o ignore (ignorata).a_faire | en_cours | fait | ignore
titlefacoltativostring1–500 caratteri
descriptionfacoltativostring | null
priorityfacoltativostringhigh | medium | low
source_langfacoltativostringLa lingua del nuovo titolo / della nuova descrizione. Ignorato se nessuno dei due cambia.2–5 caratteri
Richiesta
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à

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

Rimuovi un'attività dal piano d'azione.

Strumento MCP delete_todo

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
todoIdnel percorsostringIl suo id.
Richiesta
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.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi