# get_agent_task

Status, steps and cost of an agent task.

Status, steps and cost of an agent task.

| | |
|---|---|
| REST operation | [`getAgentTask`](/reference/rest/agent/#getagenttask) (`GET /v1/agent/tasks/{taskId}`) |
| Needs a device | no |
| Read only | yes |
| Profiles | `full` |

## Parameters

| Name | Required | Type | Goes to | What it is |
|---|---|---|---|---|
| `task_id` | yes | string | path `taskId` |  |

## Example call

```text
get_agent_task({ task_id: … })
```