DocumentaçãoReferência da API
Tarefas agendadas
As tarefas agendadas: criar, alterar, executar na hora e ler as execuções delas.
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 agendadas | GET /tasks | Grátis |
| Obter uma tarefa agendada | GET /tasks/{taskId} | Grátis |
| Criar uma tarefa agendada | POST /tasks | Grátis |
| Atualizar uma tarefa agendada | PATCH /tasks/{taskId} | Grátis |
| Excluir uma tarefa agendada | DELETE /tasks/{taskId} | Grátis |
| Executar uma tarefa agendada | POST /tasks/{taskId}/run | Cobrado |
| Listar as execuções de uma tarefa agendada | GET /tasks/{taskId}/runs | Grátis |
Listar as tarefas agendadas
/tasksGrátisTodas as tarefas agendadas do espaço de trabalho: a mensagem, a programação, o estado, a próxima e a última execução.
Ferramenta MCP list_scheduled_tasks
curl https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…"Responde 200 com { "data": … }.
Obter uma tarefa agendada
/tasks/{taskId}GrátisUma tarefa agendada.
Ferramenta MCP get_scheduled_task
| Argumento | Tipo | Descrição |
|---|---|---|
taskIdno caminho | string | O id dele. |
curl https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Responde 200 com { "data": … }.
Criar uma tarefa agendada
/tasksGrátisCria uma tarefa agendada: uma mensagem que o assistente executa sozinho, segundo uma programação, como nas Tarefas do aplicativo.
- Ela começa ativa: a primeira execução é no próximo horário da programação.
- Cada execução é uma conversa do espaço de trabalho, cobrada como uma mensagem do chat. Uma ação que sai do semchat (publicar, postar) pedida na mensagem é feita na hora, como em qualquer chat.
Ferramenta MCP create_scheduled_task
| Argumento | Tipo | Descrição |
|---|---|---|
nameobrigatório | string | O nome da tarefa, como a lista mostra.1–120 caracteres |
promptobrigatório | string | A mensagem que o assistente executa a cada vez, escrita como no chat. Ela pode citar um site (“/site:example.com”: os dados e conectores dele), uma competência (“/<skill-id>”), um endereço de e-mail (“/email:paul@example.com”), um canal do Discord (“/discord:<id>”), uma conta Slack ou Notion (“/slack:<id>”, “/notion:<id>”).1–8000 caracteres |
scheduleobrigatório | string | null | Quando ela roda: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (em um mês mais curto: o último dia), ou { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 ou 12). |
timezoneobrigatório | string | O fuso horário dos horários dela, por exemplo "Europe/Paris". |
site_idopcional | string | null | O site a que ela se refere, para a lista (null: nenhum). Padrão: o primeiro site que a mensagem cita. |
curl -X POST https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…", "prompt": "…", "schedule": "…", "timezone": "…"}'Responde 201 com { "data": … }.
Atualizar uma tarefa agendada
/tasks/{taskId}GrátisAltera uma tarefa agendada: o nome, a mensagem, a programação, o fuso horário ou o site, ou pausa e retoma a tarefa (status).
- Só o autor da tarefa, ou o proprietário ou um administrador do espaço de trabalho, pode alterar, executar ou excluir uma tarefa: caso contrário, 403 FORBIDDEN.
- Só os campos enviados mudam; pelo menos um é obrigatório. Uma nova programação ou fuso horário, ou uma retomada, leva a próxima execução para o próximo horário da programação a partir de agora.
Ferramenta MCP update_scheduled_task
| Argumento | Tipo | Descrição |
|---|---|---|
taskIdno caminho | string | O id dele. |
nameopcional | string | O nome da tarefa, como a lista mostra.1–120 caracteres |
promptopcional | string | A mensagem que o assistente executa a cada vez, escrita como no chat. Ela pode citar um site (“/site:example.com”: os dados e conectores dele), uma competência (“/<skill-id>”), um endereço de e-mail (“/email:paul@example.com”), um canal do Discord (“/discord:<id>”), uma conta Slack ou Notion (“/slack:<id>”, “/notion:<id>”).1–8000 caracteres |
scheduleopcional | string | null | Quando ela roda: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (em um mês mais curto: o último dia), ou { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 ou 12). |
timezoneopcional | string | O fuso horário dos horários dela, por exemplo "Europe/Paris". |
site_idopcional | string | null | O site a que ela se refere, para a lista (null: nenhum). Padrão: o primeiro site que a mensagem cita. |
statusopcional | string | "paused": ela para de rodar; "active": ela é retomada (a contagem de erros dela é zerada).active | paused |
curl -X PATCH https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Responde 200 com { "data": … }.
Excluir uma tarefa agendada
/tasks/{taskId}GrátisExclui uma tarefa agendada. As execuções anteriores e as conversas delas continuam.
- Só o autor da tarefa, ou o proprietário ou um administrador do espaço de trabalho, pode alterar, executar ou excluir uma tarefa: caso contrário, 403 FORBIDDEN.
Ferramenta MCP delete_scheduled_task
| Argumento | Tipo | Descrição |
|---|---|---|
taskIdno caminho | string | O id dele. |
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Responde 204 com { "data": … }.
Executar uma tarefa agendada
/tasks/{taskId}/runCobradoExecuta uma tarefa agendada agora, como o “Lançar agora” do aplicativo: uma execução, sem mudar a programação.
- Só o autor da tarefa, ou o proprietário ou um administrador do espaço de trabalho, pode alterar, executar ou excluir uma tarefa: caso contrário, 403 FORBIDDEN.
- Responde na hora com o id da execução; a execução continua em segundo plano: leia list_scheduled_task_runs para ver a conversa e o resumo dela.
- 409 CONFLICT enquanto uma das execuções dela estiver em andamento; 402 INSUFFICIENT_TOKENS sem créditos.
Ferramenta MCP run_scheduled_task
| Argumento | Tipo | Descrição |
|---|---|---|
taskIdno caminho | string | O id dele. |
curl -X POST https://app.semchat.io/api/v1/tasks/{taskId}/run \
-H "Authorization: Bearer sk_live_…"Responde 202 com { "data": … }.
Listar as execuções de uma tarefa agendada
/tasks/{taskId}/runsGrátisAs últimas execuções de uma tarefa agendada, da mais recente para a mais antiga: o estado de cada uma, a conversa, o título e o resumo.
Ferramenta MCP list_scheduled_task_runs
| Argumento | Tipo | Descrição |
|---|---|---|
taskIdno caminho | string | O id dele. |
curl https://app.semchat.io/api/v1/tasks/{taskId}/runs \
-H "Authorization: Bearer sk_live_…"Responde 200 com { "data": … }.
Não encontrou a resposta? Fale com a gente.

