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çãoChamada
Listar as tarefasGET /sites/{siteId}/todosGrátis
Criar uma tarefaPOST /sites/{siteId}/todosGrátis
Atualizar uma tarefaPATCH /sites/{siteId}/todos/{todoId}Grátis
Excluir uma tarefaDELETE /sites/{siteId}/todos/{todoId}Grátis

Listar as tarefas

GET/sites/{siteId}/todosGrátis

O plano de ação do site.

Ferramenta MCP list_todos

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
Requisição
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…"
Resposta · 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"
    }
  ]
}

Criar uma tarefa

POST/sites/{siteId}/todosGrátis

Adiciona 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

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
titleobrigatóriostringO que fazer.1–500 caracteres
descriptionopcionalstringaté 4000 caracteres
priorityopcionalstringhigh, medium (padrão) ou low.high | medium | low
categoryopcionalstringO pilar do plano a que ela pertence. Padrão: technical.technical | content | accessibility | backlinks | competitors
source_langopcionalstringO idioma em que o texto está escrito (por exemplo "fr", "en"). Se omitido: o idioma do conteúdo do site.2–5 caracteres
Requisição
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'
Resposta · 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"
  }
}

Atualizar uma tarefa

PATCH/sites/{siteId}/todos/{todoId}Grátis

Altera 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

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
todoIdno caminhostringO id dele.
statusopcionalstringa_faire (a fazer), en_cours (em andamento), fait (concluída) ou ignore (ignorada).a_faire | en_cours | fait | ignore
titleopcionalstring1–500 caracteres
descriptionopcionalstring | null
priorityopcionalstringhigh | medium | low
source_langopcionalstringO idioma do novo título / da nova descrição. Ignorado quando nenhum dos dois muda.2–5 caracteres
Requisição
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

DELETE/sites/{siteId}/todos/{todoId}Grátis

Remove uma tarefa do plano de ação.

Ferramenta MCP delete_todo

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
todoIdno caminhostringO id dele.
Requisição
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.

Pronto para fazer seu site decolar?

Faça sua primeira pergunta - o semchat responde com um plano de ação claro em segundos.

Grátis · sem cadastro · em 5 segundos