---
title: "StopService"
method: POST
path: "/gitpod.v1.EnvironmentAutomationService/StopService"
tags: ["gitpod.v1.EnvironmentAutomationService"]
---

# StopService

`POST /gitpod.v1.EnvironmentAutomationService/StopService`

Stops an automation service. This call does not block until the service is stopped.
 This call will not error if the service is already stopped or has been stopped.

 Use this method to:
 - Pause service operations
 - Gracefully stop services
 - Prepare for updates

 ### Examples

 - Stop service:

   Gracefully stops a running service.

   ```yaml
   id: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
   ```

## Request body

- GitpodV1StopServiceRequest
  - `id` string, uuid

## Response `200`

Success

- GitpodV1StopServiceResponse

## Other responses

- `default` — Error

---

[API](https://skmtc.net/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.net/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/versions/44d50c2ac284/schema)