---
title: "Describe a task entity with the given ID"
method: GET
path: "/workflow/{workflowId}/task/{taskId}"
tags: ["workflows"]
---

# Describe a task entity with the given ID

`GET /workflow/{workflowId}/task/{taskId}`

## Path parameters

- `workflowId` string, required
- `taskId` integer, required

## Query parameters

- `workspaceId` integer

## Response `200`

OK

- DescribeTaskResponse
  - `task` Task
    - `attempt` integer
    - `cloudZone` string
    - `complete` string, date-time
    - `container` string
    - `cost` number
    - `cpus` integer
    - `dateCreated` string, date-time, nullable
    - `disk` integer
    - `duration` integer
    - `env` string
    - `errorAction` string
    - `errorMessage` string, nullable
    - `executor` string
    - `exit` integer
    - `exitStatus` integer
    - `gpuMetrics` GpuMetrics
      - `active_time` integer
      - `avg_mem` integer
      - `avg_mem_bw_util` number, double
      - `driver` string
      - `mem` integer
      - `name` string
      - `pct` number, double
      - `pct_mem` number, double
      - `peak` number, double
      - `peak_mem` number, double
      - `peak_mem_bw_util` number, double
      - `peak_mem_used` integer
    - `hash` string
    - `id` integer, nullable
    - `invCtxt` integer
    - `lastUpdated` string, date-time, nullable
    - `logStreamId` string
    - `machineType` string
    - `memory` integer
    - `module` string[]
    - `name` string
    - `nativeId` string
    - `numSpotInterruptions` integer
    - `pcpu` number, double
    - `peakRss` integer
    - `peakVmem` integer
    - `pmem` number, double
    - `priceModel` 'standard' | 'spot'
    - `process` string
    - `queue` string
    - `rchar` integer
    - `readBytes` integer
    - `realtime` integer
    - `resourceAllocation` ResourceAllocation
      - `acceleratorCount` integer
      - `acceleratorName` string
      - `acceleratorType` string
      - `cpuShares` integer
      - `memoryMiB` integer
      - `time` string
    - `rss` integer
    - `scratch` string
    - `script` string
    - `start` string, date-time
    - `status` 'NEW' | 'SUBMITTED' | 'RUNNING' | 'CACHED' | 'COMPLETED' | 'FAILED' | 'ABORTED', required
    - `submit` string, date-time
    - `syscr` integer
    - `syscw` integer
    - `tag` string
    - `taskId` integer, required
    - `time` integer
    - `vmem` integer
    - `volCtxt` integer
    - `wchar` integer
    - `workdir` string
    - `writeBytes` integer

## Other responses

- `400` — Bad request
- `403` — Operation not allowed

---

[API](https://skmtc.net/seqeralabs/apis/seqera-api.md) · [All operations](https://skmtc.net/seqeralabs/apis/seqera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seqeralabs/seqera-api/revisions/13316c9fe5ff/schema)