---
title: "List active and historic tasks."
method: POST
path: "/management/v1/warehouse/{warehouse_id}/task/list"
tags: ["tasks"]
---

# List active and historic tasks.

`POST /management/v1/warehouse/{warehouse_id}/task/list`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/management/v1/warehouse/{warehouse_id}/task/list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/docs/management/v1/warehouse/:warehouse_id/task/list/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `warehouse_id` string, uuid, required

## Request body

- ListTasksRequest
  - `created-after` string, date-time, nullable: Filter tasks created after this timestamp
  - `created-before` string, date-time, nullable: Filter tasks created before this timestamp
  - `entities` WarehouseTaskEntityFilter[], nullable: Filter by specific entity
    - union
      - object: Get tasks for a specific table
        - `table-id` string, uuid, required
        - `type` 'table', required
      - object: Get tasks for a specific view
        - `type` 'view', required
        - `view-id` string, uuid, required
      - object: Get tasks for a specific generic table
        - `generic-table-id` string, uuid, required
        - `type` 'generic-table', required
      - object: Get Warehouse-level tasks which are not associated with a specific entity inside the warehouse
        - `type` 'warehouse', required
  - `page-size` integer, nullable: Number of results per page
  - `page-token` string, nullable: Next page token, re-use the same request as for the original request, but set this to the `next_page_token` from the previous response. Stop iterating when no more items are returned in a page.
  - `queue-name` string[], nullable: Filter by one or more queue names
  - `status` TaskStatus[], nullable: Filter by task status

## Response `200`

- ListTasksResponse
  - `next-page-token` string, nullable: Token for the next page of results
  - `tasks` WarehouseTaskInfo[], required: List of tasks
    - `attempt` integer, required: Current attempt number
    - `created-at` string, date-time, required: When this task attempt was created
    - `entity` union
      - object
        - `table-id` string, uuid, required
        - `type` 'table', required
      - object
        - `type` 'view', required
        - `view-id` string, uuid, required
      - object
        - `generic-table-id` string, uuid, required
        - `type` 'generic-table', required
    - `entity-name` string[], nullable: Name of the entity this task operates on. None if this is a warehouse-level task.
    - `last-heartbeat-at` string, date-time, nullable: Last heartbeat timestamp for running tasks
    - `parent-task-id` string, uuid, nullable: Parent task ID if this is a sub-task
    - `picked-up-at` string, date-time, nullable: When the latest attempt of the task was picked up for processing by a worker.
    - `progress` number, float, required: Progress of the task (0.0 to 1.0)
    - `project-id` string, required: Project ID associated with the task
    - `queue-name` string, required: Name of the queue processing this task
    - `scheduled-for` string, date-time, required: When the latest attempt of the task is scheduled for
    - `status` 'RUNNING' | 'SCHEDULED' | 'STOPPING' | 'CANCELLED' | 'SUCCESS' | 'FAILED', required
    - `task-id` string, uuid, required: Unique identifier for the task
    - `updated-at` string, date-time, nullable: When the task was last updated
    - `warehouse-id` string, uuid, required: Warehouse ID associated with the task

## Other responses

- `4XX`

---

[API](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api.md) - [All operations](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/revisions/c5cb9a12a98c?raw)