DocumentaçãoReferência da API
Plano de ação
O plano de ação de um site: listar, adicionar, alterar e excluir as tarefas dele.
Cada operação abaixo também é uma ferramenta MCP, com o mesmo nome. As operações marcadas Grátis não custam nada; as marcadas Cobrado usam os créditos do espaço de trabalho, como no aplicativo (Quanto custa).
| Operação | Chamada | |
|---|---|---|
| Listar as tarefas | GET /sites/{siteId}/todos | Grátis |
| Criar uma tarefa | POST /sites/{siteId}/todos | Grátis |
| Atualizar uma tarefa | PATCH /sites/{siteId}/todos/{todoId} | Grátis |
| Excluir uma tarefa | DELETE /sites/{siteId}/todos/{todoId} | Grátis |
Listar as tarefas
/sites/{siteId}/todosGrátisO plano de ação do site.
Ferramenta MCP list_todos
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
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"
}
]
}Criar uma tarefa
/sites/{siteId}/todosGrátisAdiciona uma tarefa ao plano de ação do site.
- Adicionada como tarefa manual (source manuel), a fazer (status a_faire). Responde com a tarefa.
Ferramenta MCP create_todo
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
titleobrigatório | string | O que fazer.1–500 caracteres |
descriptionopcional | string | até 4000 caracteres |
priorityopcional | string | high, medium (padrão) ou low.high | medium | low |
categoryopcional | string | O pilar do plano a que ela pertence. Padrão: technical.technical | content | accessibility | backlinks | competitors |
source_langopcional | string | O idioma em que o texto está escrito (por exemplo "fr", "en"). Se omitido: o idioma do conteúdo do site.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"
}
}Atualizar uma tarefa
/sites/{siteId}/todos/{todoId}GrátisAltera uma tarefa do plano de ação: o status (a fazer, em andamento, concluída, ignorada), o título, a descrição ou a prioridade.
- Responde com a tarefa como ela ficou.
- O texto volta como está salvo, no idioma em que foi escrito (source_lang; null = o idioma do conteúdo do site). O aplicativo traduz o texto na exibição; a API não.
Ferramenta MCP update_todo
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
todoIdno caminho | string | O id dele. |
statusopcional | string | a_faire (a fazer), en_cours (em andamento), fait (concluída) ou ignore (ignorada).a_faire | en_cours | fait | ignore |
titleopcional | string | 1–500 caracteres |
descriptionopcional | string | null | |
priorityopcional | string | high | medium | low |
source_langopcional | string | O idioma do novo título / da nova descrição. Ignorado quando nenhum dos dois muda.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 com { "data": … }.
Excluir uma tarefa
/sites/{siteId}/todos/{todoId}GrátisRemove uma tarefa do plano de ação.
Ferramenta MCP delete_todo
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
todoIdno caminho | string | O id dele. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
-H "Authorization: Bearer sk_live_…"Responde 204 com { "data": … }.
Não encontrou a resposta? Fale com a gente.

