---
title: "Get a Task"
method: GET
path: "/tasks/{uuid}"
tags: ["tasks"]
---

# Get a Task

`GET /tasks/{uuid}`

This operation gets a Task.

## Path parameters

- `uuid` string, UUID, required

## Response `200`

Success

- Task — Task details
  - `status` string — Task status
  - `last_update_time` string, date-time — UTC date and time in RFC-3339 format when task was last updated
  - `logical_timestamp` integer — The logical timestamp
  - `start_time` string, date-time — UTC date and time in RFC-3339 format when Task execution started
  - `creation_time` string, date-time — UTC date and time in RFC-3339 format when task was created
  - `completion_time` string, date-time — UTC date and time in RFC-3339 format when Task execution completed
  - `percentage_complete` integer — The completion percentage for the task
  - `parent_task_reference` TaskReference — The reference to a task
    - `kind` string, required — The kind name
    - `name` string
    - `uuid` string, UUID, required
  - `error_detail` string — In case of task failure this field will provide the error description
  - `uuid` string, UUID — UUID of the task.
  - `entity_reference_list` Reference[]
    - `kind` string, required
    - `uuid` string, UUID, required
    - `name` string
  - `subtask_reference_list` TaskReference[] — Reference to the sub-tasks
    - `kind` string, required — The kind name
    - `name` string
    - `uuid` string, UUID, required
  - `progress_message` string — Description of what currently the task is doing
  - `operation_type` string — Type of the operation tracked by the task
  - `error_code` string — In case of task failure this field will provide the error code
  - `cluster_reference` ClusterReference — The reference to a cluster
    - `kind` string, required — The kind name
    - `name` string
    - `uuid` string, UUID, required
  - `api_version` string — API version

## Other responses

- `404` — Invalid UUID provided
- `default` — Internal Error

---

[API](https://skmtc.net/nutanix/apis/nutanix-intentful-api.md) · [All operations](https://skmtc.net/nutanix/apis/nutanix-intentful-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nutanix/nutanix-intentful-api/revisions/40395083ab31/schema)