> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
last_verified: 2026-05-13
title: "Delete a contact"
description: "Delete a contact from your Protocol contact list. Once deleted, it cannot be recovered."
endpoint: "/v1/contacts/{id}"
method: "DELETE"
---


**Endpoint**: `DELETE /v1/contacts/{id}`
**Auth**: `Authorization: Bearer <api_key>` (required)
**Path parameters**: `id` — the contact id to delete
**Idempotency**: deleting a missing contact returns 404 (not idempotent); deletion is irreversible
**Error envelope**: 4xx/5xx return `{"error": {"code": string, "message": string}}`


<ApiEndpoint
  method="DELETE"
  endpoint="/v1/contacts/{id}"
  description="This endpoint allows you to delete a contact from your Protocol contact list. Once a contact is deleted, it cannot be recovered."
>
    <section>
      ## Path parameters

      <ApiAttribute
        name="id"
        type="string"
        description="The unique identifier of the contact to delete."
        required={true}
      />
    </section>

    <section>
      ## Request example

      <MultiLanguageCodeBlock
        languages={["javascript", "bash"]}
        value={[
          {
            language: 'javascript',
            code: `fetch('https://api.protocol.chat/v1/contacts/WAz8eIbvDR60rouK', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer {token}'
  }
})`
          },
          {
            language: 'bash',
            code: `curl -X DELETE https://api.protocol.chat/v1/contacts/WAz8eIbvDR60rouK \\
  -H "Authorization: Bearer {token}"`
          }
        ]}
      />

      ```json {{ title: 'Response' }}
      {
        "success": true,
        "message": "Contact successfully deleted"
      }
      ```
    </section>
</ApiEndpoint>