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

# Delete Lead

> Permanently delete a lead from your database

# Delete Lead

Permanently remove a lead from your database. This action cannot be undone.

<Warning>
  This action is irreversible. Make sure you really want to delete this lead
  before proceeding.
</Warning>

## Request

<ParamField path="leadId" type="string" required>
  The unique identifier of the lead to delete
</ParamField>

<ParamField header="x-api-key" type="string" required>
  Your API key with `leads:write` permission
</ParamField>

## Examples

### Delete Lead

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.buena.ai/api/v2/leads/lead_123abc" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.buena.ai/api/v2/leads/lead_123abc", {
    method: "DELETE",
    headers: {
      "x-api-key": "YOUR_API_KEY",
    },
  });

  const data = await response.json();
  console.log(data);
  ```

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

  response = requests.delete(
      'https://api.buena.ai/api/v2/leads/lead_123abc',
      headers={
          'x-api-key': 'YOUR_API_KEY'
      }
  )

  print(response.json())
  ```
</CodeGroup>

## Response

<ResponseField name="success" type="boolean">
  Always `true` for successful requests
</ResponseField>

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

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "message": "Lead lead_123abc has been successfully deleted"
  }
  ```
</ResponseExample>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Lead" icon="plus" href="/api-reference/leads/create">
    Create a new lead
  </Card>

  <Card title="List Leads" icon="list" href="/api-reference/leads/list">
    View remaining leads
  </Card>
</CardGroup>