Delete and confirmations

Delete

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

POST / v1 / delete

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} 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}.

Needs your confirmation MCP tool delete_item

Changes nothing at once. The answer has a link that the account owner confirms in Tentary. Confirmations

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
}'

const response = await fetch("https://api.tentary.com/v1/delete", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "kind": "landing_page",
    "id": 901
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/delete",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "kind": "landing_page",
        "id": 901,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/delete');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'kind' => 'landing_page',
        'id' => 901,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "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."
}

Authorization

Authorization string header required

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

Body application/json

kind string required

What to delete.

Allowed values: productcoursemodulelessonlanding_pageemail_campaignemail_automationautomation_email
id integer required

The id of the thing.

min 1

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

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.