---
title: "Run a task now"
description: "Starts a run of a task at once, whatever its trigger, and returns the run. A paused task can be run this way too."
url: "https://openemail.uk/docs/api/tasks/run"
area: "API"
category: "Mailbox"
---

# 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`

## 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**

```
curl -X POST "$OE/tasks/tsk_4b9e2c7a1f3d86e05a9c2b7d/run" -H "$AUTH"
```

**Response**

```
{
  "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 ann@example.com: Re: Invoice 1042",
      "args": {
        "threadId": "thr_7c1e4a90",
        "to": ["ann@example.com"],
        "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.

## Reference

- [`POST /tasks/{id}/run`](https://openemail.uk/docs/api/reference/tasks#post-tasks-id-run): full reference