Customers and access

Revoke access

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 / access / revoke

Takes away access that was granted: by POST /v1/access/grant, an import, Zapier or the Tentary app.

Access from a purchase stays. To end it, use POST /v1/orders/{order_id}/refund, or POST /v1/orders/{order_id}/cancel-subscription with access now. Both need confirmation.
The customer and their learning progress stay. A later POST /v1/access/grant gives the access back.

Changes at once MCP tool revoke_access

curl -X POST "https://api.tentary.com/v1/access/revoke" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "[email protected]",
  "product_id": 101
}'

const response = await fetch("https://api.tentary.com/v1/access/revoke", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "email": "[email protected]",
    "product_id": 101
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/access/revoke",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "email": "[email protected]",
        "product_id": 101,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/access/revoke');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'email' => '[email protected]',
        'product_id' => 101,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "status": "revoked",
  "message": "Access revoked. Access from purchases stays: use refund_order, or cancel_subscription with access now, for that.",
  "revoked_grants": 1,
  "customer_id": 404
}

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

email string required

The customer's e-mail address.

min length 3 max length 255
product_id integer required

The id from list_products.

min 1
variant_id integer

Only the grant of this variant. Leave out for all variants of the product.

min 0

Response

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

status string

The status.

Allowed values: revokednot_found
message string

What happened, in words for the seller.
revoked_grants integer

Number of grants that were revoked.
customer_id integer can be null

The customer ID.