---
title: "Controller Refresh Live Flow Dataset Async Status"
method: GET
path: "/refresh-live-flow-dataset/status/{task_id}"
---

# Controller Refresh Live Flow Dataset Async Status

`GET /refresh-live-flow-dataset/status/{task_id}`

Query the status of a currently running ad-hoc, asynchronous refresh of a given dataset. If complete, the location of a result will be provided -- query that location with a GET to receive the result. If failed, the error will be provided.

## Path parameters

- `task_id` string, required

## Response `200`

Successful Response

- APIStatusResponse
  - `status` 'PENDING' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'UNKNOWN_TIMEOUT', required — Celery task status enum. Update apps/web-backend-api/src/types/TaskStatusEnum.ts if you update this enum.
  - `metadata` union, required — Metadata, contextually dependent on the status of the task being queried.
    - APIStatusMetadataPending
      - `type` 'PENDING'
    - APIStatusMetadataInProgress
      - `type` 'IN_PROGRESS'
      - `estimate_seconds` number, nullable — If provided, an estimate of how many seconds we expect this task to take. This value should be treated as a rough estimate on a best-effort basis, not a guarantee.
    - APIStatusMetadataSucceeded
      - `type` 'SUCCEEDED'
      - `location` string, required — The path at which you can submit a GET request to retrieve the result of the successful job. May require proper authentication or authorization to access.
    - APIStatusMetadataFailed
      - `type` 'FAILED'
      - `error` string — If provided, a text representation of what went wrong with the task, including if any action on your part may rectify the issue.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/akkio/apis/fastapi.md) · [All operations](https://skmtc.net/akkio/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akkio/fastapi/versions/6662a407c637/schema)