API
Run a task now
Starts a run of a task at once, whatever its trigger, and returns the run. A paused task can be run this way too.
POST/tasks/{id}/run
Runs the real call on your workspace.
POST /tasks/{id}/run
Starts a run of a task at once, whatever its trigger, and returns the run. A paused task can be run this way too.
Example
Needs what creating the task would.
curl -X POST "$OE/tasks/tsk_4b9e2c7a1f3d86e05a9c2b7d/run" -H "$AUTH"{ "object": "task_run", "id": "run_9d3a7e1c5b2f48a60c7e1d3b", "taskId": "tsk_4b9e2c7a1f3d86e05a9c2b7d", "taskName": "Morning summary", "trigger": "schedule", "threadId": null, "status": "waiting", "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.", "autonomy": "organize", "model": "standard", "steps": 4, "toolCalls": 6, "actions": 1, "result": null, "error": null, "errorDetail": null, "pendingApprovals": 1, "createdAt": "2026-10-13T07:00:04.112Z", "startedAt": "2026-10-13T07:00:05.870Z", "finishedAt": null, "transcript": [ { "role": "user", "text": "Go through the mail that arrived since yesterday. …", "at": "2026-10-13T07:00:05.870Z", "calls": [] }, { "role": "assistant", "text": "", "at": "2026-10-13T07:00:09.402Z", "calls": [ { "id": "call_1", "tool": "listThreads", "args": { "folder": "inbox", "maxResults": 20 }, "done": true, "result": "…" } ] } ], "approvals": [{ "object": "task_approval", "id": "apr_2f8c1a6e9b3d47c05e1a8f2c", "runId": "run_9d3a7e1c5b2f48a60c7e1d3b", "taskId": "tsk_4b9e2c7a1f3d86e05a9c2b7d", "taskName": "Morning summary", "tool": "replyToEmail", "summary": "Reply to [email protected]: Re: Invoice 1042", "args": { "threadId": "thr_7c1e4a90", "to": ["[email protected]"], "subject": "Re: Invoice 1042", "body": "Hi Ann, the invoice went out again this morning." }, "status": "pending", "createdAt": "2026-10-13T07:00:41.220Z", "expiresAt": "2026-10-20T07:00:41.220Z", "decidedAt": null }]}The answer comes back at once with the run queued. Read it again with GET /task-runs/{id} to follow it.
It counts towards maxRunsPerDay: 409 task_run_limit_reached when the task has run as often as it may today.