Delete and confirmations

Confirmation

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

GET / v1 / confirmations / {confirmation_id}

The state of an action that needs the confirmation of the account owner, for example from POST /v1/email/campaigns/{campaign_id}/send, POST /v1/orders/{order_id}/refund or POST /v1/delete.

pending: not decided yet.
running: confirmed, and the action runs now. Ask again in a few seconds.
done: it ran. result has the details.
failed: it could not run. result says why.
canceled: the account owner said no.
expired: the link expired.

Reads only MCP tool get_confirmation

curl "https://api.tentary.com/v1/confirmations/7" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/confirmations/7", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/confirmations/7",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/confirmations/7');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "id": 7,
  "action": "refund_order",
  "target_id": 1003,
  "summary": "Refund order R5D7H2B8 (31.20 EUR)",
  "status": "done",
  "result": {
    "order_id": 1003,
    "refunded": "31.20",
    "currency": "EUR"
  },
  "created_at": "2026-10-27T08:51:48Z",
  "expires_at": "2026-10-27T08:56:48Z",
  "decided_at": "2026-10-27T08:51:48Z"
}

Authorization

Authorization string header required

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

Path parameters

confirmation_id integer required

The confirmation_id from the tool that asked.

min 1 Example: 7

Response

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

id integer

The ID.
action string

The tool that asked, like refund_order or delete_product.
target_id integer

The ID of the thing.
summary string

Short summary.
status string

pending = not decided yet. running = confirmed, the action runs now. done = it ran. failed = it could not run. canceled = the seller said no.

Allowed values: pendingrunningdonefailedcanceledexpired
result object can be null

done: the details of the action, like order_id and refunded, or campaign_id, send_at and estimated_recipients. failed and canceled: message (and error). null while pending or running.
created_at string<date-time> can be null

UTC, like 2026-01-31T14:05:00Z.
expires_at string<date-time> can be null

UTC, like 2026-01-31T14:05:00Z.
decided_at string<date-time> can be null

UTC, like 2026-01-31T14:05:00Z.