DocumentazioneRiferimento API

Attività pianificate

Le attività pianificate: crearle, modificarle, avviarle subito e leggerne le esecuzioni.

Ogni operazione qui sotto è anche uno strumento MCP, con lo stesso nome. Le operazioni Gratis non costano nulla; quelle A pagamento usano i crediti dello spazio di lavoro, come nell'app (Quanto costa).

OperazioneChiamata
Elenca le attività pianificateGET /tasksGratis
Leggi un'attività pianificataGET /tasks/{taskId}Gratis
Crea un'attività pianificataPOST /tasksGratis
Modifica un'attività pianificataPATCH /tasks/{taskId}Gratis
Elimina un'attività pianificataDELETE /tasks/{taskId}Gratis
Avvia un'attività pianificataPOST /tasks/{taskId}/runA pagamento
Elenca le esecuzioni di un'attività pianificataGET /tasks/{taskId}/runsGratis

Elenca le attività pianificate

GET/tasksGratis

Tutte le attività pianificate dello spazio di lavoro: il messaggio, la pianificazione, lo stato, la prossima e l'ultima esecuzione.

Strumento MCP list_scheduled_tasks

Richiesta
curl https://app.semchat.io/api/v1/tasks \
  -H "Authorization: Bearer sk_live_…"

Risponde 200 con { "data": … }.

Leggi un'attività pianificata

GET/tasks/{taskId}Gratis

Un'attività pianificata.

Strumento MCP get_scheduled_task

ArgomentoTipoDescrizione
taskIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…"

Risponde 200 con { "data": … }.

Crea un'attività pianificata

POST/tasksGratis

Crea un'attività pianificata: un messaggio che l'assistente esegue da solo secondo una pianificazione, come nelle Attività dell'app.

  • Nasce attiva: la sua prima esecuzione è alla prossima ora della pianificazione.
  • Ogni esecuzione è una conversazione dello spazio di lavoro, addebitata come un messaggio della chat. Un'azione fuori da semchat (pubblicare, inviare) richiesta dal suo messaggio viene fatta subito, come in qualsiasi chat.

Strumento MCP create_scheduled_task

ArgomentoTipoDescrizione
nameobbligatoriostringIl nome dell'attività, come lo mostra l'elenco.1–120 caratteri
promptobbligatoriostringIl messaggio che l'assistente esegue ogni volta, scritto come nella chat. Può nominare un sito («/site:example.com»: i suoi dati e i suoi connettori), una competenza («/<skill-id>»), un indirizzo email («/email:paul@example.com»), un canale Discord («/discord:<id>»), un account Slack o Notion («/slack:<id>», «/notion:<id>»).1–8000 caratteri
scheduleobbligatoriostring | nullQuando viene eseguita: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (in un mese più corto: il suo ultimo giorno), oppure { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 o 12).
timezoneobbligatoriostringIl fuso orario dei suoi orari, per es. "Europe/Paris".
site_idfacoltativostring | nullIl sito a cui si riferisce, per l'elenco (null: nessuno). Se omesso: il primo sito nominato nel suo messaggio.
Richiesta
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": "…"}'

Risponde 201 con { "data": … }.

Modifica un'attività pianificata

PATCH/tasks/{taskId}Gratis

Modifica un'attività pianificata: il nome, il messaggio, la pianificazione, il fuso orario o il sito, oppure mettila in pausa e riattivala (status).

  • Solo il suo autore, il proprietario o un amministratore dello spazio di lavoro può modificare, avviare o eliminare un'attività: altrimenti 403 FORBIDDEN.
  • Cambiano solo i campi indicati; ne serve almeno uno. Una nuova pianificazione, un nuovo fuso orario o una riattivazione spostano la prossima esecuzione alla prossima ora della pianificazione a partire da adesso.

Strumento MCP update_scheduled_task

ArgomentoTipoDescrizione
taskIdnel percorsostringIl suo id.
namefacoltativostringIl nome dell'attività, come lo mostra l'elenco.1–120 caratteri
promptfacoltativostringIl messaggio che l'assistente esegue ogni volta, scritto come nella chat. Può nominare un sito («/site:example.com»: i suoi dati e i suoi connettori), una competenza («/<skill-id>»), un indirizzo email («/email:paul@example.com»), un canale Discord («/discord:<id>»), un account Slack o Notion («/slack:<id>», «/notion:<id>»).1–8000 caratteri
schedulefacoltativostring | nullQuando viene eseguita: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (in un mese più corto: il suo ultimo giorno), oppure { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 o 12).
timezonefacoltativostringIl fuso orario dei suoi orari, per es. "Europe/Paris".
site_idfacoltativostring | nullIl sito a cui si riferisce, per l'elenco (null: nessuno). Se omesso: il primo sito nominato nel suo messaggio.
statusfacoltativostring"paused": smette di essere eseguita; "active": riprende (il suo conteggio degli errori viene azzerato).active | paused
Richiesta
curl -X PATCH https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

Risponde 200 con { "data": … }.

Elimina un'attività pianificata

DELETE/tasks/{taskId}Gratis

Elimina un'attività pianificata. Le sue esecuzioni passate e le loro conversazioni restano.

  • Solo il suo autore, il proprietario o un amministratore dello spazio di lavoro può modificare, avviare o eliminare un'attività: altrimenti 403 FORBIDDEN.

Strumento MCP delete_scheduled_task

ArgomentoTipoDescrizione
taskIdnel percorsostringIl suo id.
Richiesta
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…"

Risponde 204 con { "data": … }.

Avvia un'attività pianificata

POST/tasks/{taskId}/runA pagamento

Avvia subito un'attività pianificata, come «Avvia ora» nell'app: una sola esecuzione, la sua pianificazione resta invariata.

  • Solo il suo autore, il proprietario o un amministratore dello spazio di lavoro può modificare, avviare o eliminare un'attività: altrimenti 403 FORBIDDEN.
  • Risponde subito con l'id dell'esecuzione; l'esecuzione continua in background: leggi list_scheduled_task_runs per la sua conversazione e il suo riepilogo.
  • 409 CONFLICT mentre è in corso una delle sue esecuzioni; 402 INSUFFICIENT_TOKENS se non ci sono crediti.

Strumento MCP run_scheduled_task

ArgomentoTipoDescrizione
taskIdnel percorsostringIl suo id.
Richiesta
curl -X POST https://app.semchat.io/api/v1/tasks/{taskId}/run \
  -H "Authorization: Bearer sk_live_…"

Risponde 202 con { "data": … }.

Elenca le esecuzioni di un'attività pianificata

GET/tasks/{taskId}/runsGratis

Le ultime esecuzioni di un'attività pianificata, dalla più recente: lo stato di ciascuna, la sua conversazione, il titolo e il riepilogo.

Strumento MCP list_scheduled_task_runs

ArgomentoTipoDescrizione
taskIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/tasks/{taskId}/runs \
  -H "Authorization: Bearer sk_live_…"

Risponde 200 con { "data": … }.

Hai una domanda a cui qui non trovi risposta? Scrivici.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi