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).
| Operazione | Chiamata | |
|---|---|---|
| Elenca le attività pianificate | GET /tasks | Gratis |
| Leggi un'attività pianificata | GET /tasks/{taskId} | Gratis |
| Crea un'attività pianificata | POST /tasks | Gratis |
| Modifica un'attività pianificata | PATCH /tasks/{taskId} | Gratis |
| Elimina un'attività pianificata | DELETE /tasks/{taskId} | Gratis |
| Avvia un'attività pianificata | POST /tasks/{taskId}/run | A pagamento |
| Elenca le esecuzioni di un'attività pianificata | GET /tasks/{taskId}/runs | Gratis |
Elenca le attività pianificate
/tasksGratisTutte le attività pianificate dello spazio di lavoro: il messaggio, la pianificazione, lo stato, la prossima e l'ultima esecuzione.
Strumento MCP list_scheduled_tasks
curl https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Leggi un'attività pianificata
/tasks/{taskId}GratisUn'attività pianificata.
Strumento MCP get_scheduled_task
| Argomento | Tipo | Descrizione |
|---|---|---|
taskIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Crea un'attività pianificata
/tasksGratisCrea 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
| Argomento | Tipo | Descrizione |
|---|---|---|
nameobbligatorio | string | Il nome dell'attività, come lo mostra l'elenco.1–120 caratteri |
promptobbligatorio | string | Il 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 |
scheduleobbligatorio | string | null | Quando 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). |
timezoneobbligatorio | string | Il fuso orario dei suoi orari, per es. "Europe/Paris". |
site_idfacoltativo | string | null | Il sito a cui si riferisce, per l'elenco (null: nessuno). Se omesso: il primo sito nominato nel suo messaggio. |
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
/tasks/{taskId}GratisModifica 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
| Argomento | Tipo | Descrizione |
|---|---|---|
taskIdnel percorso | string | Il suo id. |
namefacoltativo | string | Il nome dell'attività, come lo mostra l'elenco.1–120 caratteri |
promptfacoltativo | string | Il 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 |
schedulefacoltativo | string | null | Quando 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). |
timezonefacoltativo | string | Il fuso orario dei suoi orari, per es. "Europe/Paris". |
site_idfacoltativo | string | null | Il sito a cui si riferisce, per l'elenco (null: nessuno). Se omesso: il primo sito nominato nel suo messaggio. |
statusfacoltativo | string | "paused": smette di essere eseguita; "active": riprende (il suo conteggio degli errori viene azzerato).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": "…"}'Risponde 200 con { "data": … }.
Elimina un'attività pianificata
/tasks/{taskId}GratisElimina 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
| Argomento | Tipo | Descrizione |
|---|---|---|
taskIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Risponde 204 con { "data": … }.
Avvia un'attività pianificata
/tasks/{taskId}/runA pagamentoAvvia 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
| Argomento | Tipo | Descrizione |
|---|---|---|
taskIdnel percorso | string | Il suo id. |
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
/tasks/{taskId}/runsGratisLe 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
| Argomento | Tipo | Descrizione |
|---|---|---|
taskIdnel percorso | string | Il suo id. |
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.

