---
title: "Delete Opportunity Status"
method: DELETE
path: "/opportunityStatuses/{ID}"
tags: ["Opportunities / Statuses"]
---

# Delete Opportunity Status

`DELETE /opportunityStatuses/{ID}`

## Request

- Base URL: `https://api.forcemanager.com/api/v4`
- URL: `https://api.forcemanager.com/api/v4/opportunityStatuses/{ID}`
- Auth: API key in header `X-Session-Key`

This endpoint allows you to delete a specific Opportunity Status from the user's ForceManager implementation database. If the specified Opportunity Status does not exist, the response will be a "bad request". This operation cannot be undone.

You will only be able to delete Opportunity Statuses after first providing the Session Key. To know how you can obtain the Session Key, [go to Authentication](#tag/authentication/POST/login).

**HEADERS**

| **Parameter** | **Value** | **Description** |
| --- | --- | --- |
| Content-Type | application/json | Language in which all request and response bodies are encoded |
| Accept | \*/\* | Any data of whatever mime type is accepted |
| X-Session-Key | AUTH_TOKEN | This field must be completed with the token obtained at the authentication |

**REQUEST**

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| id | Integer | The unique and specific identifier of the Opportunity Status to delete |

**RESPONSE**

Returns a JSON with information about the Opportunity Status just deleted.

| **Attribute** | **Type** | **Description** |
| --- | --- | --- |
| Message | String | Shows the operation status |

**RESPONSE CODES**

| **Status** | **Description** |
| --- | --- |
| 200 OK | Shows if operation succeeded |
| 400 Bad Request | Shows when an invalid request or the requested service is not available |

## Headers

- `Accept` string

## Response `200`

Delete Opportunity Status

---

[API](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer.md) · [All operations](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/llms.txt) · [OpenAPI document](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/revisions/87db17204e2f?raw)