---
title: "Update a task"
method: POST
path: "/api/tasks/update-v2"
tags: ["task-resource"]
---

# Update a task

`POST /api/tasks/update-v2`

## Request body

- TaskResult
  - `callbackAfterSeconds` integer
  - `executionMetadata` ExecutionMetadata
    - `additionalContext` object
    - `additionalContextMap` object
    - `clientReceiveTime` integer
    - `clientSendTime` integer
    - `empty` boolean
    - `executionDuration` integer
    - `executionEndTime` integer
    - `executionStartTime` integer
    - `pollNetworkLatency` integer
    - `serverSendTime` integer
    - `updateNetworkLatency` integer
  - `extendLease` boolean
  - `externalOutputPayloadStoragePath` string
  - `logs` TaskExecLog[]
    - `createdTime` integer
    - `log` string
    - `taskId` string
  - `orCreateExecutionMetadata` ExecutionMetadata
    - `additionalContext` object
    - `additionalContextMap` object
    - `clientReceiveTime` integer
    - `clientSendTime` integer
    - `empty` boolean
    - `executionDuration` integer
    - `executionEndTime` integer
    - `executionStartTime` integer
    - `pollNetworkLatency` integer
    - `serverSendTime` integer
    - `updateNetworkLatency` integer
  - `outputData` object
  - `reasonForIncompletion` string
  - `status` 'IN_PROGRESS' | 'FAILED' | 'FAILED_WITH_TERMINAL_ERROR' | 'COMPLETED' | 'CANCELED'
  - `subWorkflowId` string
  - `supportsCancellation` boolean
  - `taskId` string, required
  - `workerId` string
  - `workflowInstanceId` string, required

## Response `200`

OK

---

[API](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server.md) · [All operations](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orkescloud/orkes-conductor-api-server/revisions/6ebf0c14ac41/schema)