---
title: "Task"
description: "a run a caller started through a tool: its progress, what it asks, and how it ended"
section: concepts
address: /concepts/task
contract: 0476e35e6e275db5
---

# Task

a run a caller started through a tool: its progress, what it asks, and how it ended

[figure: Task is a view at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | view |
| scope | none |
| key | the run, as one caller sees it |
| store | derived |
| family | harness |



## Fields


| field | type | required | note |
|---|---|---|---|
| `run` | `id` | yes |  |
| `progress` | [Progress](/concepts/progress) | yes |  |
| `asks` | [TaskQuestion](/concepts/taskquestion) | yes |  |
| `ended` | `one of running \| waiting \| ended \| failed \| stopped` | yes |  |
| `result` | [Card](/concepts/card) | no |  |



## Routes that use it
- [`/v1/work/run_procedure`](/reference/work/run_procedure) returns it
- [`/v1/work/status`](/reference/work/status) returns it
- [`/v1/work/local_procedure`](/reference/work/local_procedure) returns it
- [`/v1/harness/delegate`](/reference/harness/delegate) returns it