---
title: "Deploy Service"
method: POST
path: "/v1/environments/{envId}/services/{serviceId}/deploy"
---

# Deploy Service

`POST /v1/environments/{envId}/services/{serviceId}/deploy`

Trigger a deployment for a specific service within an environment.

## Path parameters

- `envId` string, required
- `serviceId` string, required

## Request body

- union
  - object
    - `commit_id` string, required — The Git commit ID to deploy
  - object
    - `docker_image_tag` string, required — The Docker image tag to deploy
  - object
    - `helm_chart_version` string, required — The Helm chart version to deploy
  - object
    - `preview` true, required — Set to true to trigger a preview deployment
    - `commit_id` string, required — The Git commit ID to deploy for preview

## Response `200`

Deployment triggered successfully

## Changes

- **2026-02-17** `e62c5cb7c79f` — 1 info
  - added `subschema #4: Preview Deployment` to the request body `oneOf` list
- **2026-01-08** `4516da1a4380` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/localopsco/apis/localops-api/changes/v1/environments/:envId/services/:serviceId/deploy/post.md)

---

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