# Delete

`POST https://api.tentary.com/v1/delete`

Source: https://tentary.com/de/help/api/delete-item/
Area: Löschen und Bestätigungen
MCP tool: `delete_item`. Changes nothing at once. The answer has a link that the account owner confirms in Tentary.

---

Deletes or archives one thing. What happens depends on the type:

- **`product`** is archived. Buyers cannot buy it, earlier buyers keep access, it leaves its shop categories, and bundles that contain it do not show it.
- **`course`** is archived. Buyers cannot open it until the account owner restores it in the app.
- **`module`** and **`lesson`** are deleted with everything in them. The course keeps a backup of the outline. Refused while another lesson waits for one of them.
- **`landing_page`** is deleted. Not possible for the shop home page.
- **`email_campaign`** is deleted. Drafts only.
- **`email_automation`** and **`automation_email`** are deleted. Inactive ones only.

Alternatives without confirmation:

- To switch a coupon off, use [`PATCH /v1/coupons/{coupon_id}`](https://tentary.com/de/help/api/update-coupon/) with `status` `archived`.
- To only hide a landing page or a product, set its `status` to `draft`.

**After the call:** the account owner confirms at the `confirm_url` within 5 minutes. Then check the result with [`GET /v1/confirmations/{confirmation_id}`](https://tentary.com/de/help/api/get-confirmation/).

## Authorization

`Authorization: Bearer <API key>`

A personal API key (tnt_...). Create it in the Tentary app on the page AI & API.

## Request body

- `kind` (string, required): What to delete. Allowed values: `product`, `course`, `module`, `lesson`, `landing_page`, `email_campaign`, `email_automation`, `automation_email`.
- `id` (integer, required): The id of the thing. Limits: min 1.

## Response

The action waits for the seller's confirmation.

- `status` (string): Nothing happened yet. Allowed values: `needs_confirmation`.
- `confirmation_id` (integer): For get_confirmation.
- `confirm_url` (string<uri>): The seller opens it while logged in to Tentary and confirms.
- `expires_at` (string<date-time>): UTC, like 2026-01-31T14:05:00Z. The link works until then.
- `summary` (string): What the seller confirms.
- `message` (string): Next steps for the AI app.

## Example request

```bash
curl -X POST "https://api.tentary.com/v1/delete" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "landing_page",
  "id": 901
}'
```

## Example response

```json
{
  "status": "needs_confirmation",
  "confirmation_id": 5,
  "confirm_url": "https://app.tentary.com/ai/confirm/fYvp2UwV0kn5_crlAefkASWP4A9a7E1t",
  "expires_at": "2026-10-27T08:56:48Z",
  "summary": "Delete landing page \"Retreat 2027\"",
  "message": "Nothing happened yet. Give the seller the confirm_url: they open it while logged in to Tentary and confirm within 5 minutes. Then call get_confirmation to see the result. If the link expired, call this tool again."
}
```