---
title: "Changes to Start a new Deployment."
method: POST
path: "/orgs/{orgId}/apps/{appId}/envs/{envId}/deploys"
---

# Changes to Start a new Deployment.

`POST /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 9 revisions.

- **2026-08-10** `e21ad140ec3c`: 3 info
- **2025-06-21** `4db6186594e3`: 1 info

## Changes

- **2026-08-10** `e21ad140ec3c`: 3 info
  - added the new optional request property `mode`
  - added the optional property `mode` to the response with the `201` status
  - added the optional property `operator_version` to the response with the `201` status
- **2025-06-21** `4db6186594e3`: 1 info
  - added the optional property `legacy_mode` to the response with the `201` status

---

[Operation](https://skmtc.dev/humanitec/apis/humanitec-api/docs/orgs/:orgId/apps/:appId/envs/:envId/deploys/post.md) - [API](https://skmtc.dev/humanitec/apis/humanitec-api.md) - [Page](https://skmtc.dev/humanitec/apis/humanitec-api/changes/orgs/:orgId/apps/:appId/envs/:envId/deploys/post)