> ## Documentation Index
> Fetch the complete documentation index at: https://doc.convo.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /project/{project_id}/wa_template/{id} — Remove

> DELETE /project/{project_id}/wa_template/{id} — Permanently delete a WhatsApp Message Template. Review WhatsApp deletion policies before proceeding.

Permanently delete a WhatsApp Message Template from your project. This action removes the template from Convo and triggers deletion from WhatsApp's systems.

<Warning>
  **WhatsApp enforces a 30-day cooldown on deleted template names.** After deletion, you cannot submit a new template using the same `name` for 30 days. Additionally, deleting a template that is actively used in running campaigns will immediately break those sends. Review your active campaigns before deleting any template.
</Warning>

## Endpoint

```text theme={null}
DELETE https://connect.api-wa.co/project-apis/v1/project/{project_id}/wa_template/{wa_template_id}
```

## Authentication

```text theme={null}
X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD
```

## Path Parameters

<ParamField path="project_id" type="string" required>
  Your Convo project ID.
</ParamField>

<ParamField path="wa_template_id" type="string" required>
  The unique ID of the WhatsApp Message Template to delete. This is the `_id` field returned from the [Submit Template](/api-reference/templates/submit-template), [List Templates](/api-reference/templates/list-templates), or [Get Template](/api-reference/templates/get-template) endpoints.
</ParamField>

## Request Example

```bash theme={null}
curl -X DELETE "https://connect.api-wa.co/project-apis/v1/project/YOUR_PROJECT_ID/wa_template/64a1f3bc9e4a2b001c3d7f12" \
  -H "X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD"
```

## Response

A successful deletion returns `200 OK` with a status confirmation.

```json theme={null}
{
  "status": "success"
}
```

There is no additional data returned. Once deleted, the template cannot be recovered.

## What Happens After Deletion

* The template is **immediately removed** from your Convo project.
* WhatsApp deletes the template from their platform, which may take a short time to propagate.
* Any API campaign linked to this template will fail to send until reconfigured with a different template.
* The template `name` is **locked for 30 days** — you cannot resubmit a template with the same name during this period.

<Note>
  If you want to update a template's content, the recommended approach is to submit a new template with a versioned name (e.g., `shipping_update_v2`) rather than deleting and recreating the existing one. This avoids the cooldown period and keeps existing campaigns functional.
</Note>

## Error Responses

| Status                      | Description                                                         |
| --------------------------- | ------------------------------------------------------------------- |
| `404 Not Found`             | No template with the given `wa_template_id` exists in your project. |
| `500 Internal Server Error` | An unexpected server-side error occurred.                           |

```json theme={null}
{
  "error": "Not Found",
  "message": "Template with id '64a1f3bc9e4a2b001c3d7f12' not found."
}
```