Legal texts

Update legal texts

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

PATCH / v1 / legal

Saves legal texts of the shop as HTML. Allowed tags: h2 to h5, p, ul, li, strong, a, br and hr.

Only the texts that you send change. An empty text removes the document.
Buyers see the change at once.

Start from GET /v1/legal/templates/{document} and fill in the real data of the account. Never invent it. GET /v1/legal shows which documents the country of the account needs.

Changes at once MCP tool update_legal_texts

curl -X PATCH "https://api.tentary.com/v1/legal" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "attach_terms_to_order_emails": true
}'

const response = await fetch("https://api.tentary.com/v1/legal", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "attach_terms_to_order_emails": true
  }),
});
const data = await response.json();

import os
import requests

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

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

200 · Response

{
  "country": "DE",
  "documents": [
    {
      "document": "terms",
      "title": "Terms of service",
      "filled": true,
      "html": "<h2>Terms of service</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "cancellation",
      "title": "Cancellation policy",
      "filled": true,
      "html": "<h2>Cancellation policy</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "privacy",
      "title": "Privacy policy",
      "filled": true,
      "html": "<h2>Privacy policy</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "imprint",
      "title": "Legal notice (Impressum)",
      "filled": true,
      "html": "<h2>Impressum</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    }
  ],
  "attach_terms_to_order_emails": true,
  "admin_url": "https://app.tentary.com/settings/legal",
  "shop_url": "https://shop.tentary.com/legal/61326/tos"
}

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

terms_html string

Terms of service.

max length 200000
cancellation_html string

EU: cancellation policy. Other countries: return and refund policy.

max length 200000
privacy_html string

Privacy policy.

max length 200000
imprint_html string

Germany, Austria, Switzerland: Impressum. Other countries: contact information.

max length 200000
attach_terms_to_order_emails boolean

Attach the terms and the cancellation policy as a PDF to every order e-mail.

Response

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

country string

Seller country, like DE. It decides which documents the shop needs.
documents array of object

The legal documents for the seller country.
Show 4 fields Hide fields
- document string
  
  terms, cancellation, privacy or imprint.
  
  Allowed values: termscancellationprivacyimprint
- title string
  
  Name of the document for the seller country.
- filled boolean
  
  true = the text is not empty.
- html string
  
  The text as HTML.
attach_terms_to_order_emails boolean

true = the terms and the cancellation policy go as a PDF with every order e-mail.
admin_url string<uri>

The page in the Tentary app.
shop_url string<uri>

The terms in the shop.