Routines & missions · schedule_task
Schedule a task
One-off or recurring action at the chosen time.
- Price
- included
- Requirements
- No connector
- runs on platform keys
- Human approval
- No
- read or internal write
- Reliability
- Verified
- not measured yet · 0.2 s
Input
| Field | Type | Description |
|---|---|---|
| title * | string | Short label (e.g. "Rapport hebdomadaire", "Relancer Dupont") |
| description | string | Optional description of what the task does |
| prompt * | string | The full instruction Copilote will execute when the task runs |
| frequency * | manual | once | hourly | daily | weekdays | weekly | monthly | event | How often to run: manual (on-demand), once (specific date), daily, weekdays (Mon-Fri), weekly (Monday), monthly (1st of the month), hourly — at `time` (default 09:00 Europe/Paris); event = whenever the business event `eventTopic` happens (no clock) |
| eventTopic | support.ticket_created | sales.lead_created | support.incident_declared | sales.email_received | For frequency=event: the business event that fires the routine. |
| eventMailbox | string | For eventTopic "sales.email_received": only messages arriving in THIS mailbox fire the routine (the connected account address, or a shared mailbox such as sav@…). Always set it when the workspace has more than one mailbox: a SAV routine must not answer prospect replies, and a prospecting routine must not treat customer requests. |
| time | string | For daily/weekdays/weekly/monthly: local time "HH:MM" (Europe/Paris), e.g. "08:30". Default 09:00. |
| missionId | string | Mission served by this routine (id from mission_plan / list_missions). |
| runAt | string | For frequency=once: PREFER a relative expression over ISO datetime — the server computes the exact time so clock drift is never an issue. Examples: "in 10 minutes", "in 3 days", "in 1 week", "tomorrow", "dans 10 minutes", "dans 3 jours". ISO 8601 also accepted (e.g. "2026-04-18T14:00:00+02:00"). |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"schedule_task","input":{"title":"…","description":"…","prompt":"…","frequency":"manual"}}'$
run({ "tool": "schedule_task", "input": {"title":"…","description":"…","prompt":"…","frequency":"manual"} })