---
title: "List active and historic Project-level tasks."
method: POST
path: "/management/v1/project/task/list"
tags: ["tasks"]
---

# List active and historic Project-level tasks.

`POST /management/v1/project/task/list`

## Request

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

## Headers

- `x-project-id` string, nullable

## Request body

- ListProjectTasksRequest
  - `created-after` string, date-time, nullable: Filter tasks created after this timestamp
  - `created-before` string, date-time, nullable: Filter tasks created before this timestamp
  - `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`

- ListProjectTasksResponse
  - `next-page-token` string, nullable: Token for the next page of results
  - `tasks` ProjectTaskInfo[], required: List of tasks
    - `attempt` integer, required: Current attempt number
    - `created-at` string, date-time, required: When this task attempt was created
    - `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

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