---
title: "Deletes a Lead Status"
method: DELETE
path: "/LeadStatuses"
tags: ["LeadStatuses"]
---

# Deletes a Lead Status

`DELETE /LeadStatuses`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/LeadStatuses`
- Auth: none declared. Required headers: `Authorization`

This endpoint is used to delete an existing lead status.

## Query parameters

- `id` integer, required

## Headers

- `Authorization` string, required

## Response `202`

Delete succeeded.

## Other responses

- `401`: Authentication failed.
- `403`: API User does not have permission to delete Lead Statuses or Lead Management disabled.
- `404`: Lead Status not found.
- `409`: Lead Status cannot be deleted because it's in use or if you only have one OPEN and one CLOSED Lead Status in your instance.
- `417`: Delete failed.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)