API
Pause and resume
Pausing stops a task from starting runs. Resuming turns it back on and clears its count of failed runs.
POST/tasks/{id}/pause
Runs any of 2 calls on your workspace.
POST /tasks/{id}/pause
Pausing stops a task from starting runs. Resuming turns it back on and clears its count of failed runs.
Example
Pausing needs tasks:write. Resuming needs what creating the task would.
curl -X POST "$OE/tasks/tsk_4b9e2c7a1f3d86e05a9c2b7d/pause" -H "$AUTH"curl -X POST "$OE/tasks/tsk_4b9e2c7a1f3d86e05a9c2b7d/resume" -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"}A run that is already going carries on. Cancel it if it should stop too.
Mail that arrived while a task was paused does not start it afterwards, and a schedule picks up at its next time, not the ones it missed.
Resuming counts against the plan like creating: 403 task_active_limit_reached when the plan runs no more tasks at once.