DocumentaciónReferencia de la API
Plan de acción
El plan de acción de un sitio: listar, añadir, cambiar y eliminar sus tareas.
Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).
| Operación | Llamada | |
|---|---|---|
| Listar las tareas | GET /sites/{siteId}/todos | Gratis |
| Crear una tarea | POST /sites/{siteId}/todos | Gratis |
| Modificar una tarea | PATCH /sites/{siteId}/todos/{todoId} | Gratis |
| Eliminar una tarea | DELETE /sites/{siteId}/todos/{todoId} | Gratis |
Listar las tareas
/sites/{siteId}/todosGratisEl plan de acción del sitio.
Herramienta MCP list_todos
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su 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"
}
]
}Crear una tarea
/sites/{siteId}/todosGratisAñade una tarea al plan de acción del sitio.
- Se añade como tarea manual (source manuel), pendiente (status a_faire). Responde con la tarea.
Herramienta MCP create_todo
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
titleobligatorio | string | Lo que hay que hacer.1–500 caracteres |
descriptionopcional | string | hasta 4000 caracteres |
priorityopcional | string | high, medium (por defecto) o low.high | medium | low |
categoryopcional | string | El pilar del plan al que pertenece. Por defecto, technical.technical | content | accessibility | backlinks | competitors |
source_langopcional | string | El idioma en que está escrito el texto (p. ej. "fr", "en"). Si se omite: el idioma del contenido del sitio.2–5 caracteres |
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"
}
}Modificar una tarea
/sites/{siteId}/todos/{todoId}GratisCambia una tarea del plan de acción: su estado (pendiente, en curso, hecha, ignorada), su título, su descripción o su prioridad.
- Responde con la tarea tal como queda.
- El texto se devuelve tal como está guardado, en el idioma en que se escribió (source_lang; null = el idioma del contenido del sitio). La aplicación lo traduce al mostrarlo; la API no.
Herramienta MCP update_todo
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
todoIden la ruta | string | Su id. |
statusopcional | string | a_faire (pendiente), en_cours (en curso), fait (hecha) o ignore (ignorada).a_faire | en_cours | fait | ignore |
titleopcional | string | 1–500 caracteres |
descriptionopcional | string | null | |
priorityopcional | string | high | medium | low |
source_langopcional | string | El idioma del nuevo título o de la nueva descripción. Se ignora si ninguno de los dos cambia.2–5 caracteres |
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"}'Responde 200 con { "data": … }.
Eliminar una tarea
/sites/{siteId}/todos/{todoId}GratisQuita una tarea del plan de acción.
Herramienta MCP delete_todo
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
todoIden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
-H "Authorization: Bearer sk_live_…"Responde 204 con { "data": … }.
¿No encuentras la respuesta? Escríbenos.

