---
title: "deprovision a service instance"
method: DELETE
path: "/v2/service_instances/{instance_id}"
tags: ["ServiceInstances"]
---

# deprovision a service instance

`DELETE /v2/service_instances/{instance_id}`

## Path parameters

- `instance_id` string, required

## Query parameters

- `service_id` string, required
- `plan_id` string, required
- `accepts_incomplete` boolean

## Headers

- `X-Broker-API-Version` string, required
- `X-Broker-API-Originating-Identity` string

## Response `200`

OK

- Object

## Other responses

- `202` — Accepted
- `400` — Bad Request
- `410` — Gone
- `422` — Unprocessable Entity

## Changes

- **2018-01-19** `0caa6bfec4d2` — 4 warning
  - removed the optional property `description` from the response with the `400` status
  - removed the optional property `description` from the response with the `410` status
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `410` status
- **2018-01-19** `3dae1f5deefb` — 4 info
  - added the optional property `description` to the response with the `400` status
  - added the optional property `description` to the response with the `410` status
  - added the optional property `error` to the response with the `400` status
  - added the optional property `error` to the response with the `410` status
- **2018-01-09** `48af75e14707` — 2 breaking
  - the response's body type changed from no type to `object` for status `202`
  - the response's body type changed from no type to `object` for status `422`
- **2018-01-04** `e2d1f490e161` — 1 breaking
  - the response property `operation` became optional for the status `202`
- **2017-12-20** `826610a2f6e1` — 1 breaking, 1 info
  - the response's body type changed from `object` to no type for status `202`
  - added the required property `operation` to the response with the `202` status

[Full history](https://skmtc.dev/cloudfoundry/apis/open-service-broker-api/changes/v2/service_instances/:instance_id/delete.md)

---

[API](https://skmtc.dev/cloudfoundry/apis/open-service-broker-api.md) · [All operations](https://skmtc.dev/cloudfoundry/apis/open-service-broker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudfoundry/open-service-broker-api/revisions/0caa6bfec4d2/schema)