DocumentationRéférence de l'API
Tâches planifiées
Les tâches planifiées : les créer, les modifier, les lancer tout de suite et lire leurs lancements.
Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).
| Opération | Appel | |
|---|---|---|
| Lister les tâches planifiées | GET /tasks | Gratuit |
| Récupérer une tâche planifiée | GET /tasks/{taskId} | Gratuit |
| Créer une tâche planifiée | POST /tasks | Gratuit |
| Modifier une tâche planifiée | PATCH /tasks/{taskId} | Gratuit |
| Supprimer une tâche planifiée | DELETE /tasks/{taskId} | Gratuit |
| Lancer une tâche planifiée | POST /tasks/{taskId}/run | Facturé |
| Lister les lancements d'une tâche | GET /tasks/{taskId}/runs | Gratuit |
Lister les tâches planifiées
/tasksGratuitToutes les tâches planifiées de l'espace : leur message, leur programmation, leur état, leur prochain et leur dernier lancement.
Outil MCP list_scheduled_tasks
curl https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Récupérer une tâche planifiée
/tasks/{taskId}GratuitUne tâche planifiée.
Outil MCP get_scheduled_task
| Argument | Type | Description |
|---|---|---|
taskIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Créer une tâche planifiée
/tasksGratuitCréer une tâche planifiée : un message que l'assistant exécute tout seul selon une programmation, comme dans les Tâches de l'app.
- Elle démarre active : son premier lancement a lieu à la prochaine heure de sa programmation.
- Chaque lancement est une conversation de l'espace, facturée comme un message du chat. Une action qui sort de semchat (publier, poster) demandée par son message est faite aussitôt, comme dans n'importe quel chat.
Outil MCP create_scheduled_task
| Argument | Type | Description |
|---|---|---|
nameobligatoire | string | Le nom de la tâche, tel que la liste l'affiche.1–120 caractères |
promptobligatoire | string | Le message que l'assistant exécute à chaque fois, écrit comme dans le chat. Il peut citer un site (« /site:example.com » : ses données et ses connecteurs), une compétence (« /<skill-id> »), une adresse e-mail (« /email:paul@example.com »), un canal Discord (« /discord:<id> »), un compte Slack ou Notion (« /slack:<id> », « /notion:<id> »).1–8000 caractères |
scheduleobligatoire | string | null | Quand elle s'exécute : { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (un mois plus court : son dernier jour), ou { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 ou 12). |
timezoneobligatoire | string | Le fuseau horaire de ses heures, par ex. "Europe/Paris". |
site_idfacultatif | string | null | Le site qu'elle concerne, pour la liste (null : aucun). Par défaut, le premier site que cite son message. |
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": "…"}'Répond 201 avec { "data": … }.
Modifier une tâche planifiée
/tasks/{taskId}GratuitModifier une tâche planifiée : son nom, son message, sa programmation, son fuseau horaire ou son site, ou la mettre en pause et la réactiver (status).
- Seul son auteur, ou le propriétaire ou un administrateur de l'espace, peut modifier, lancer ou supprimer une tâche : 403 FORBIDDEN sinon.
- Seuls les champs fournis changent ; au moins un est requis. Une nouvelle programmation, un nouveau fuseau horaire ou une réactivation place le prochain lancement à la prochaine heure de la programmation, à partir de maintenant.
Outil MCP update_scheduled_task
| Argument | Type | Description |
|---|---|---|
taskIddans le chemin | string | Son identifiant. |
namefacultatif | string | Le nom de la tâche, tel que la liste l'affiche.1–120 caractères |
promptfacultatif | string | Le message que l'assistant exécute à chaque fois, écrit comme dans le chat. Il peut citer un site (« /site:example.com » : ses données et ses connecteurs), une compétence (« /<skill-id> »), une adresse e-mail (« /email:paul@example.com »), un canal Discord (« /discord:<id> »), un compte Slack ou Notion (« /slack:<id> », « /notion:<id> »).1–8000 caractères |
schedulefacultatif | string | null | Quand elle s'exécute : { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (un mois plus court : son dernier jour), ou { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 ou 12). |
timezonefacultatif | string | Le fuseau horaire de ses heures, par ex. "Europe/Paris". |
site_idfacultatif | string | null | Le site qu'elle concerne, pour la liste (null : aucun). Par défaut, le premier site que cite son message. |
statusfacultatif | string | "paused" : elle ne s'exécute plus ; "active" : elle reprend (son compteur d'erreurs est remis à zéro).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": "…"}'Répond 200 avec { "data": … }.
Supprimer une tâche planifiée
/tasks/{taskId}GratuitSupprimer une tâche planifiée. Ses lancements passés et leurs conversations restent.
- Seul son auteur, ou le propriétaire ou un administrateur de l'espace, peut modifier, lancer ou supprimer une tâche : 403 FORBIDDEN sinon.
Outil MCP delete_scheduled_task
| Argument | Type | Description |
|---|---|---|
taskIddans le chemin | string | Son identifiant. |
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Répond 204 avec { "data": … }.
Lancer une tâche planifiée
/tasks/{taskId}/runFacturéLancer une tâche planifiée maintenant, comme « Lancer maintenant » dans l'app : un seul lancement, sa programmation inchangée.
- Seul son auteur, ou le propriétaire ou un administrateur de l'espace, peut modifier, lancer ou supprimer une tâche : 403 FORBIDDEN sinon.
- Répond aussitôt avec l'id du lancement ; le lancement se poursuit en arrière-plan : lisez list_scheduled_task_runs pour sa conversation et son récapitulatif.
- 409 CONFLICT pendant qu'un de ses lancements est en cours ; 402 INSUFFICIENT_TOKENS sans crédits.
Outil MCP run_scheduled_task
| Argument | Type | Description |
|---|---|---|
taskIddans le chemin | string | Son identifiant. |
curl -X POST https://app.semchat.io/api/v1/tasks/{taskId}/run \
-H "Authorization: Bearer sk_live_…"Répond 202 avec { "data": … }.
Lister les lancements d'une tâche
/tasks/{taskId}/runsGratuitLes derniers lancements d'une tâche planifiée, du plus récent au plus ancien : l'état de chacun, sa conversation, son titre et son récapitulatif.
Outil MCP list_scheduled_task_runs
| Argument | Type | Description |
|---|---|---|
taskIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/tasks/{taskId}/runs \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Une question sans réponse ici ? Écrivez-nous.

