## Run

**post** `/api/promptly/tasks/{taskId}/run`

Execute a task immediately, regardless of its schedule

### Path Parameters

- `taskId: string`

### Returns

- `TaskRun = object { id, completedAt, costCents, 9 more }`

  - `id: optional string`

  - `completedAt: optional string`

  - `costCents: optional number`

    Cost in cents

  - `createdAt: optional string`

  - `deliveryStatus: optional "pending" or "delivered" or "failed"`

    - `"pending"`

    - `"delivered"`

    - `"failed"`

  - `durationMs: optional number`

    Execution time in milliseconds

  - `error: optional string`

    Error message if failed

  - `output: optional string`

    AI-generated output

  - `startedAt: optional string`

  - `status: optional "pending" or "running" or "completed" or "failed"`

    - `"pending"`

    - `"running"`

    - `"completed"`

    - `"failed"`

  - `taskId: optional string`

  - `tokensUsed: optional number`

    Total tokens consumed

### Example

```http
curl https://0ct.com/api/promptly/tasks/$TASK_ID/run \
    -X POST \
    -H "Authorization: Bearer $0CT_API_KEY"
```