---
title: "Changes to CreateDeployment creates a new deployment for a project."
method: POST
path: "/v1/orgs/{org}/projects/{project}/deployments"
---

# Changes to CreateDeployment creates a new deployment for a project.

`POST /v1/orgs/{org}/projects/{project}/deployments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 70 revisions.

- **2026-05-06** (v1) `0aeb660cd27f`: 1 info
- **2025-12-11** (v1) `431878c7e255`: 3 info
- **2025-11-24** (v1) `f58ec6956f04`: 6 warning, 2 info

## Changes

- **2026-05-06** (v1) `0aeb660cd27f`: 1 info
  - added the optional property `deployment/usedOn` to the response with the `200` status
- **2025-12-11** (v1) `431878c7e255`: 3 info
  - added the new optional request property `branch`
  - added the new optional request property `editable`
  - added the optional property `deployment/editable` to the response with the `200` status
- **2025-11-24** (v1) `f58ec6956f04`: 6 warning, 2 info
  - added the new `DEPLOYMENT_STATUS_DELETED` enum value to the `deployment/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_DELETING` enum value to the `deployment/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_ERRORED` enum value to the `deployment/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_RUNNING` enum value to the `deployment/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_STOPPING` enum value to the `deployment/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_UPDATING` enum value to the `deployment/status` response property for the response status `200`
  - removed the `DEPLOYMENT_STATUS_ERROR` enum value from the `deployment/status` response property for the response status `200`
  - removed the `DEPLOYMENT_STATUS_OK` enum value from the `deployment/status` response property for the response status `200`

---

[Operation](https://skmtc.dev/rilldata/apis/rill-admin-api/docs/v1/orgs/:org/projects/:project/deployments/post.md) - [API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) - [Page](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/projects/:project/deployments/post)