---
title: "Get Details about a specific task by its ID."
method: GET
path: "/management/v1/warehouse/{warehouse_id}/task/by-id/{task_id}"
tags: ["tasks"]
---

# Get Details about a specific task by its ID.

`GET /management/v1/warehouse/{warehouse_id}/task/by-id/{task_id}`

## Request

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

## Path parameters

- `warehouse_id` string, uuid, required
- `task_id` string, uuid, required

## Query parameters

- `numAttempts` integer, nullable

## Response `200`

- GetTaskDetailsResponse
  - `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
  - `attempts` TaskAttempt[], required: History of past attempts
    - `attempt` integer, required: Attempt number
    - `created-at` string, date-time, required: When this attempt was created
    - `duration` string, nullable: How long this attempt took
    - `execution-details` object, nullable: Execution details for this attempt
    - `message` string, nullable: Message associated with this attempt
    - `progress` number, float, required: Progress achieved in this attempt
    - `scheduled-for` string, date-time, required: When this attempt was scheduled for
    - `started-at` string, date-time, nullable: When this attempt started
    - `status` 'RUNNING' | 'SCHEDULED' | 'STOPPING' | 'CANCELLED' | 'SUCCESS' | 'FAILED', required
  - `execution-details` object, nullable: Execution details for the current attempt
  - `message` string, nullable: Message for the current attempt: success result details if it succeeded, or the failure reason if it failed. `null` while the attempt is still running or scheduled.
  - `task-data` object, required: Task-specific data

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