---
title: "UpdateTaskExecutionStatus"
method: POST
path: "/gitpod.v1.EnvironmentAutomationService/UpdateTaskExecutionStatus"
tags: ["gitpod.v1.EnvironmentAutomationService"]
---

# UpdateTaskExecutionStatus

`POST /gitpod.v1.EnvironmentAutomationService/UpdateTaskExecutionStatus`

UpdateTaskExecutionStatus updates the status of a task execution. Only the environment executing a task execution is expected to call this function.

## Request body

- GitpodV1UpdateTaskExecutionStatusRequest
  - `failureMessage` string, nullable — failure_message marks the task execution as failed and provides a message explaining the failure. If an individual step has failed, callers are NOT expected to set this message; only if the task execution as a whole has failed/cannot be started.
  - `id` string, uuid
  - `logUrl` string, nullable — log_url is the URL to the logs of the task's steps. If this is empty, the task either has no logs or has not yet started.
  - `steps` GitpodV1TaskExecutionStatusStep[]
    - `failureMessage` string — failure_message summarises why the step failed to operate. If this is non-empty the step has failed to operate and will likely transition to a failed state.
    - `id` string, uuid — ID is the ID of the execution step
    - `phase` 'TASK_EXECUTION_PHASE_UNSPECIFIED' | 'TASK_EXECUTION_PHASE_PENDING' | 'TASK_EXECUTION_PHASE_RUNNING' | 'TASK_EXECUTION_PHASE_SUCCEEDED' | 'TASK_EXECUTION_PHASE_FAILED' | 'TASK_EXECUTION_PHASE_STOPPED'

## Response `200`

Success

- GitpodV1UpdateTaskExecutionStatusResponse

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/27f7bd641de1/schema)