> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Lead

> Delete a lead and stop all pending outreach

This endpoint deletes a lead by its `leadId`. Deleting a lead removes it from lead lists and lookups, cancels any pending follow-ups and scheduled messages, and removes checklist items that were added specifically to this lead.

Deleted leads can no longer be fetched or updated through the API. Deleting a lead that has already been deleted returns a `404`.

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Path Parameters

<ParamField path="leadId" type="string" required>
  The Monumint lead ID to delete.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded
</ResponseField>

<ResponseField name="message" type="string">
  Confirmation message
</ResponseField>

<ResponseField name="deletedLead" type="object">
  The deleted lead.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      The lead ID
    </ResponseField>

    <ResponseField name="name" type="string">
      The lead's full name
    </ResponseField>

    <ResponseField name="deletedAt" type="string">
      ISO 8601 timestamp of when the lead was deleted
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```javascript Node.js theme={null}
  const options = {
    method: "DELETE",
    headers: {
      "x-api-key": "<your-api-key>",
    },
  };

  fetch(
    "https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
    options
  )
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```

  ```python Python theme={null}
  import requests

  lead_id = "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e"
  url = f"https://api-v2.getomni.ai/api/v1/leads/{lead_id}"
  headers = {
      "x-api-key": "<your-api-key>",
  }

  response = requests.delete(url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={null}
  curl --request DELETE \
    --url 'https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e' \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "deletedLead": {
      "deletedAt": "2026-10-06T21:00:00.000Z",
      "id": "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
      "name": "John Francisco"
    },
    "message": "Lead deleted successfully",
    "success": true
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Lead not found",
    "success": false
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.