---
title: "Store workflow task execution metadata"
method: PUT
path: "/trace/{workflowId}/progress"
tags: ["trace"]
---

# Store workflow task execution metadata

`PUT /trace/{workflowId}/progress`

Store the execution metadata for one or more tasks in the given `workflowId`.

## Path parameters

- `workflowId` string, required

## Query parameters

- `workspaceId` integer

## Request body

- TraceProgressRequest
  - `containers` ContainerData[]
    - `buildId` string
    - `cached` boolean
    - `freeze` boolean
    - `mirrorId` string
    - `requestId` string
    - `requestTime` string, date-time
    - `scanId` string
    - `sourceImage` string
    - `targetImage` string, required
  - `progress` TraceProgressData
    - `aborted` integer
    - `cached` integer
    - `failed` integer
    - `ignored` integer
    - `loadCpus` integer
    - `loadMemory` integer
    - `numSpotInterruptions` integer
    - `peakCpus` integer
    - `peakMemory` integer
    - `peakRunning` integer
    - `pending` integer
    - `processes` TraceProgressDetail[]
      - `aborted` integer
      - `cached` integer
      - `failed` integer
      - `ignored` integer
      - `index` integer
      - `loadCpus` integer
      - `loadMemory` integer
      - `name` string
      - `peakCpus` integer
      - `peakMemory` integer
      - `peakRunning` integer
      - `pending` integer
      - `retries` integer
      - `running` integer
      - `stored` integer
      - `submitted` integer
      - `succeeded` integer
      - `terminated` boolean
    - `retries` integer
    - `running` integer
    - `stored` integer
    - `submitted` integer
    - `succeeded` integer
  - `tasks` 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

## Response `200`

OK

- TraceProgressResponse
  - `status` 'OK' | 'KO'
  - `workflowId` string

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