API
Retrieve a task
One task with its trigger, its settings, and when it last ran and will run next.
GET/tasks/{id}
Runs the real call on your workspace.
GET /tasks/{id}
One task with its trigger, its settings, and when it last ran and will run next.
Example
Needs tasks:read, threads:read and emails:read.
curl "$OE/tasks/tsk_4b9e2c7a1f3d86e05a9c2b7d" -H "$AUTH"{ "object": "task", "id": "tsk_4b9e2c7a1f3d86e05a9c2b7d", "name": "Morning summary", "instruction": "Go through the mail that arrived since yesterday. Tell me which conversations need a reply from me, most urgent first, and draft a short reply for each.", "status": "active", "pausedReason": null, "trigger": { "kind": "schedule", "schedule": { "cadence": "daily", "everyHours": 1, "hour": 8, "minute": 0, "weekdays": [1, 2, 3, 4, 5], "monthDay": 1, "timezone": "Europe/London" }, "mail": null }, "autonomy": "organize", "toolkits": ["notes", "drafts", "knowledge"], "model": "standard", "notify": "attention", "maxRunsPerDay": 50, "maxSteps": 20, "nextRunAt": "2026-10-14T07:00:00.000Z", "heldUntil": null, "lastRunAt": "2026-10-13T07:00:04.112Z", "lastRunStatus": "done", "runCount": 12, "pendingApprovals": 0, "createdAt": "2026-10-01T09:12:44.000Z", "updatedAt": "2026-10-13T07:01:10.530Z"}lastRunStatus is the state of the newest run, so waiting means it has asked for something.
A task that does not exist answers 404 task_not_found.