---
title: "Changes to UpdateTask"
method: POST
path: "/gitpod.v1.EnvironmentAutomationService/UpdateTask"
---

# Changes to UpdateTask

`POST /gitpod.v1.EnvironmentAutomationService/UpdateTask`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 18 revisions.

- **2026-07-30** `44d50c2ac284` — 1 breaking, 1 warning, 2 info
- **2026-04-02** `dabc0ff98cd7` — 1 breaking, 2 info
- **2026-01-21** `2423c089f280` — 1 breaking, 2 info
- **2025-12-15** `d62ef4b9187c` — 2 breaking, 6 info
- **2025-02-21** `3655d5ad0ac3` — 2 breaking, 2 warning, 5 info
- **2025-02-18** `cd6a05ae99d2` — 1 warning

## Changes

- **2026-07-30** `44d50c2ac284` — 1 breaking, 1 warning, 2 info
  - removed `subschema #1, subschema #2, subschema #3` from the `spec/runsOn` request property `oneOf` list
  - removed the request property `spec/runsOn/terminal`
  - added the new optional request property `spec/prebuildRequiresSuccess`
  - added `subschema #1, subschema #2` to the `spec/runsOn` request property `oneOf` list
- **2026-04-02** `dabc0ff98cd7` — 1 breaking, 2 info
  - removed `subschema #1, subschema #2` from the `spec/runsOn` request property `oneOf` list
  - added the new optional request property `spec/runsOn/terminal`
  - added `subschema #1, subschema #2, subschema #3` to the `spec/runsOn` request property `oneOf` list
- **2026-01-21** `2423c089f280` — 1 breaking, 2 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` from the `metadata/triggeredBy/trigger/items/` request property `oneOf` list
  - added the new optional request property `metadata/triggeredBy/trigger/items/beforeSnapshot`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the `metadata/triggeredBy/trigger/items/` request property `oneOf` list
- **2025-12-15** `d62ef4b9187c` — 2 breaking, 6 info
  - removed `subschema #1` from the `spec/runsOn` request property `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `metadata/triggeredBy/trigger/items/` request property `oneOf` list
  - added the new optional request property `metadata/triggeredBy/trigger/items/postMachineStart`
  - added the new optional request property `metadata/triggeredBy/trigger/items/prebuild`
  - added the new optional request property `spec/env`
  - added the new optional request property `spec/runsOn/machine`
  - added `subschema #1, subschema #2` to the `spec/runsOn` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `metadata/triggeredBy/trigger/items/` request property `oneOf` list
- **2025-02-21** `3655d5ad0ac3` — 2 breaking, 2 warning, 5 info
  - the `metadata` request property type/format changed from ``/`` to `object`/``
  - the `spec` request property type/format changed from ``/`` to `object`/``
  - removed `#/components/schemas/gitpod.v1.UpdateTaskRequest.TaskMetadata` from the `metadata` request property `allOf` list
  - removed `#/components/schemas/gitpod.v1.UpdateTaskRequest.TaskSpec` from the `spec` request property `allOf` list
  - added the new optional request property `metadata/description`
  - added the new optional request property `metadata/name`
  - added the new optional request property `metadata/triggeredBy`
  - added the new optional request property `spec/command`
  - added the new optional request property `spec/runsOn`
- **2025-02-18** `cd6a05ae99d2` — 1 warning
  - removed the optional property `detail` from the response with the `default` status

---

[Operation](https://skmtc.dev/gitpod-io/apis/gitpod-v1/docs/gitpod.v1.EnvironmentAutomationService/UpdateTask/post.md) · [API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [Page](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.EnvironmentAutomationService/UpdateTask/post)