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érationAppel
Lister les tâches planifiéesGET /tasksGratuit
Récupérer une tâche planifiéeGET /tasks/{taskId}Gratuit
Créer une tâche planifiéePOST /tasksGratuit
Modifier une tâche planifiéePATCH /tasks/{taskId}Gratuit
Supprimer une tâche planifiéeDELETE /tasks/{taskId}Gratuit
Lancer une tâche planifiéePOST /tasks/{taskId}/runFacturé
Lister les lancements d'une tâcheGET /tasks/{taskId}/runsGratuit

Lister les tâches planifiées

GET/tasksGratuit

Toutes 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

Requête
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

GET/tasks/{taskId}Gratuit

Une tâche planifiée.

Outil MCP get_scheduled_task

ArgumentTypeDescription
taskIddans le cheminstringSon identifiant.
Requête
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

POST/tasksGratuit

Cré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

ArgumentTypeDescription
nameobligatoirestringLe nom de la tâche, tel que la liste l'affiche.1–120 caractères
promptobligatoirestringLe 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
scheduleobligatoirestring | nullQuand 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).
timezoneobligatoirestringLe fuseau horaire de ses heures, par ex. "Europe/Paris".
site_idfacultatifstring | nullLe site qu'elle concerne, pour la liste (null : aucun). Par défaut, le premier site que cite son message.
Requête
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

PATCH/tasks/{taskId}Gratuit

Modifier 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

ArgumentTypeDescription
taskIddans le cheminstringSon identifiant.
namefacultatifstringLe nom de la tâche, tel que la liste l'affiche.1–120 caractères
promptfacultatifstringLe 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
schedulefacultatifstring | nullQuand 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).
timezonefacultatifstringLe fuseau horaire de ses heures, par ex. "Europe/Paris".
site_idfacultatifstring | nullLe site qu'elle concerne, pour la liste (null : aucun). Par défaut, le premier site que cite son message.
statusfacultatifstring"paused" : elle ne s'exécute plus ; "active" : elle reprend (son compteur d'erreurs est remis à zéro).active | paused
Requête
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

DELETE/tasks/{taskId}Gratuit

Supprimer 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

ArgumentTypeDescription
taskIddans le cheminstringSon identifiant.
Requête
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

POST/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

ArgumentTypeDescription
taskIddans le cheminstringSon identifiant.
Requête
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

GET/tasks/{taskId}/runsGratuit

Les 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

ArgumentTypeDescription
taskIddans le cheminstringSon identifiant.
Requête
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.

Prêt à faire décoller votre site ?

Posez votre première question - semchat vous répond avec un plan d'action clair, en quelques secondes.

Gratuit · sans inscription · en 5 secondes