---
title: "POST /v1/{+name}:disable"
method: POST
path: "/v1/{+name}:disable"
tags: ["services"]
---

# POST /v1/{+name}:disable

`POST /v1/{+name}:disable`

Disable a service so that it can no longer be used with a project. This prevents unintended usage that may cause unexpected billing charges or security leaks. It is not valid to call the disable method on a service that is not currently enabled. Callers will receive a `FAILED_PRECONDITION` status if the target service is not currently enabled.

## Path parameters

- `name` string, required

## Request body

- DisableServiceRequest — Request message for the `DisableService` method.
  - `disableDependentServices` boolean — Indicates if services that are enabled and which depend on this service should also be disabled. If not set, an error will be generated if any enabled services depend on the service to be disabled. When set, the service, and any enabled services that depend on it, will be disabled together.
  - `checkIfServiceHasUsage` 'CHECK_IF_SERVICE_HAS_USAGE_UNSPECIFIED' | 'SKIP' | 'CHECK' — Defines the behavior for checking service usage when disabling a service.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/serviceusage.md) · [All operations](https://skmtc.dev/google/apis/serviceusage/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/serviceusage/revisions/f848a9887d17/schema)