---
title: "Update a workflow state by updating variables or in progress task"
method: POST
path: "/api/workflow/{workflowId}/state"
tags: ["workflow-resource"]
---

# Update a workflow state by updating variables or in progress task

`POST /api/workflow/{workflowId}/state`

Updates the workflow variables, tasks and triggers evaluation.

## Path parameters

- `workflowId` string, required

## Query parameters

- `requestId` string, required
- `waitUntilTaskRef` string
- `waitForSeconds` integer

## Request body

- WorkflowStateUpdate
  - `taskReferenceName` string
  - `taskResult` 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
  - `variables` object

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