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

# Delete partner

> Permanently delete a partner from your program

## Endpoint

```
DELETE https://api.partnero.com/v1/partners/{id}
```

<Warning>
  This action is permanent and cannot be undone. Consider using [archive](/api-reference/partners/archive) instead to preserve historical data.
</Warning>

## Parameters

You can identify the partner by path parameter or request body:

| Parameter | Location | Type   | Description                    |
| --------- | -------- | ------ | ------------------------------ |
| `id`      | path     | string | Partner's unique ID in the URL |
| `email`   | body     | string | Partner's email address        |
| `key`     | body     | string | Partner's referral key         |

## Request

<CodeGroup>
  ```bash cURL (by path ID) theme={null}
  curl --location --request DELETE 'https://api.partnero.com/v1/partners/partner_123' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```bash cURL (by email) theme={null}
  curl --location --request DELETE 'https://api.partnero.com/v1/partners' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "email": "john.doe@partnero.com"
    }'
  ```
</CodeGroup>

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "status": 1
  }
  ```
</ResponseExample>

## Error responses

| Status | Error             | Solution                                       |
| ------ | ----------------- | ---------------------------------------------- |
| 404    | Partner not found | Check the partner ID, email, or key is correct |