---
title: "StartDeployment starts a deployment."
method: POST
path: "/v1/deployments/{deploymentId}/start"
---

# StartDeployment starts a deployment.

`POST /v1/deployments/{deploymentId}/start`

## Path parameters

- `deploymentId` string, required

## Request body

- object

## Response `200`

A successful response.

- V1StartDeploymentResponse
  - `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.

---

[API](https://skmtc.net/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.net/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/versions/289a0ca9ce49/schema)