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

## Request

- Base URL: `https://api.akkio.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.akkio.com/refresh-live-flow-dataset/status/{task_id}`
- Auth: none declared

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.dev/akkio/apis/akkio-api.md) - [All operations](https://skmtc.dev/akkio/apis/akkio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akkio/apis/akkio-api/revisions/c477deff6271?raw)