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

# CreateDeployment creates a new deployment for a project.

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

## Path parameters

- `org` string, required
- `project` string, required

## Request body

- object
  - `branch` string — Branch to deploy from. Must not be set for `prod` deployments, uses project's default branch. This limitation can be lifted in the future if needed. Optional for `dev` deployments.
  - `editable` boolean — Whether the deployment is editable and the edited changes are persisted back to the git repo. Can't be set for `prod` deployments.
  - `environment` string

## Response `200`

A successful response.

- V1CreateDeploymentResponse
  - `deployment` V1Deployment
    - `branch` string
    - `createdOn` string, date-time
    - `editable` boolean
    - `environment` string
    - `id` string
    - `ownerUserId` string
    - `projectId` string
    - `runtimeHost` string
    - `runtimeInstanceId` string
    - `status` 'DEPLOYMENT_STATUS_UNSPECIFIED' | 'DEPLOYMENT_STATUS_PENDING' | 'DEPLOYMENT_STATUS_RUNNING' | 'DEPLOYMENT_STATUS_ERRORED' | 'DEPLOYMENT_STATUS_STOPPED' | 'DEPLOYMENT_STATUS_UPDATING' | 'DEPLOYMENT_STATUS_STOPPING' | 'DEPLOYMENT_STATUS_DELETING' | 'DEPLOYMENT_STATUS_DELETED'
    - `statusMessage` string
    - `updatedOn` string, date-time
    - `usedOn` string, date-time

## Other responses

- `default` — An unexpected error response.

## Changes

> 54 revisions in range; 1 could not be searched.

- **2026-05-06** (v1) `0aeb660cd27f` — 1 info
  - added the optional property `deployment/usedOn` to the response with the `200` status
- **2025-12-11** (v1) `f317ff96998d` — 1 warning
  - removed the optional property `deployment/usedOn` from the response with the `200` status

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

---

[API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.dev/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/revisions/abe7a430f373/schema)