v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
gitpod.v1.EnvironmentAutomationService

DeleteService

Deletes an automation service. This call does not block until the service is deleted. If the service is not stopped it will be stopped before deletion.

Use this method to:

  • Remove unused services
  • Clean up service configurations
  • Stop and delete services

Examples

  • Delete service:

    Removes a service after stopping it.

    id: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
    force: false
    
  • Force delete:

    Immediately removes a service.

    id: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
    force: true
    
post/gitpod.v1.EnvironmentAutomationService/DeleteService

Request body

forceboolean
idstring uuid

Response

Success

GitpodV1DeleteServiceResponse required