---
title: "Poll for completion of tasks"
method: POST
path: "/tasks/poll"
tags: ["tasks"]
---

# Poll for completion of tasks

`POST /tasks/poll`

Poll for completion of tasks

## Request body

- TaskPollInput — Input for a task poll
  - `poll_timeout_seconds` integer, required — Poll timeout in seconds
  - `task_uuid_list` string[], required — List of task UUIDs to poll on

## Response `200`

Success

- TaskPollResponse — Response from a task poll request
  - `entities` Task[]
    - `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
  - `has_poll_timed_out` boolean — Did the poll timeout before all polled tasks completed

## Other responses

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