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çãoChamada
Listar as tarefas agendadasGET /tasksGrátis
Obter uma tarefa agendadaGET /tasks/{taskId}Grátis
Criar uma tarefa agendadaPOST /tasksGrátis
Atualizar uma tarefa agendadaPATCH /tasks/{taskId}Grátis
Excluir uma tarefa agendadaDELETE /tasks/{taskId}Grátis
Executar uma tarefa agendadaPOST /tasks/{taskId}/runCobrado
Listar as execuções de uma tarefa agendadaGET /tasks/{taskId}/runsGrátis

Listar as tarefas agendadas

GET/tasksGrátis

Todas 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

Requisição
curl https://app.semchat.io/api/v1/tasks \
  -H "Authorization: Bearer sk_live_…"

Responde 200 com { "data": … }.

Obter uma tarefa agendada

GET/tasks/{taskId}Grátis

Uma tarefa agendada.

Ferramenta MCP get_scheduled_task

ArgumentoTipoDescrição
taskIdno caminhostringO id dele.
Requisição
curl https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…"

Responde 200 com { "data": … }.

Criar uma tarefa agendada

POST/tasksGrátis

Cria 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

ArgumentoTipoDescrição
nameobrigatóriostringO nome da tarefa, como a lista mostra.1–120 caracteres
promptobrigatóriostringA 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óriostring | nullQuando 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óriostringO fuso horário dos horários dela, por exemplo "Europe/Paris".
site_idopcionalstring | nullO site a que ela se refere, para a lista (null: nenhum). Padrão: o primeiro site que a mensagem cita.
Requisição
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

PATCH/tasks/{taskId}Grátis

Altera 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

ArgumentoTipoDescrição
taskIdno caminhostringO id dele.
nameopcionalstringO nome da tarefa, como a lista mostra.1–120 caracteres
promptopcionalstringA 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
scheduleopcionalstring | nullQuando 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).
timezoneopcionalstringO fuso horário dos horários dela, por exemplo "Europe/Paris".
site_idopcionalstring | nullO site a que ela se refere, para a lista (null: nenhum). Padrão: o primeiro site que a mensagem cita.
statusopcionalstring"paused": ela para de rodar; "active": ela é retomada (a contagem de erros dela é zerada).active | paused
Requisição
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

DELETE/tasks/{taskId}Grátis

Exclui 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

ArgumentoTipoDescrição
taskIdno caminhostringO id dele.
Requisição
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…"

Responde 204 com { "data": … }.

Executar uma tarefa agendada

POST/tasks/{taskId}/runCobrado

Executa 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

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

GET/tasks/{taskId}/runsGrátis

As ú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

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

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