Produkte und Dateien

Update product

Als Markdown anzeigen Rohes Markdown in neuem Tab In ChatGPT öffnen Zu dieser Seite befragen In Claude öffnen Zu dieser Seite befragen

PATCH / v1 / products / {product_id}

Changes the fields that you send. All other fields stay.

status live publishes the product. This needs a finished account setup and content. draft hides it.
content replaces all content blocks. Call GET /v1/products/{product_id} first and send back the blocks that should stay, with their file_id.
null removes an optional value: compare_at_price, intro_price, limited_offer, dates, limits, url_slug and banner.
course_id changes the course that buyers of a course product get.

The fields have the same names and formats as in GET /v1/products/{product_id}.

Ändert sofort MCP-Werkzeug update_product

curl -X PATCH "https://api.tentary.com/v1/products/105" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "price": 19,
  "compare_at_price": 24,
  "show_in_search": true
}'

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

import os
import requests

response = requests.patch(
    "https://api.tentary.com/v1/products/105",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "price": 19,
        "compare_at_price": 24,
        "show_in_search": True,
    },
)
data = response.json()

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

200 · Antwort

{
  "id": 105,
  "name": "Yoga Workbook",
  "type": "download",
  "status": "draft",
  "url": "https://lena-yoga.mytentary.com/p/d2hpTs",
  "admin_url": "https://app.tentary.com/products/edit/105",
  "note": "The product is a draft: buyers cannot see it. Set status live to publish it."
}

Autorisierung

Authorization string Header erforderlich

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

Pfad-Parameter

product_id integer erforderlich

The id from list_products.

min. 1 Beispiel: 105

Body application/json

status string

live = buyers can see and buy it. draft = hidden.

Mögliche Werte: draftlive
name string

Product name.

min. Länge 1 max. Länge 255
price number | string kann null sein

Amount in the account currency, like 49 or 19.99. 0 = free. Paid prices start at 1.00. For external: the price shown on the card.

min. 0 Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
billing string

Default one_time.

Mögliche Werte: one_timesubscription
billing_interval_months integer kann null sein

subscription: months between payments, default 1.

min. 1 max. 12
intro_price number | string kann null sein

subscription: price of the first period, less than price.

min. 0 Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
installment_plans array of object

one_time: payment plans that buyers can choose. [] removes them.

max. Einträge 5
2 Felder anzeigen Felder ausblenden
- count integer erforderlich
  
  min. 2 max. 100
- amount number | string erforderlich
  
  Per installment. Amount in the account currency, like 49 or 19.99.
  
  Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
compare_at_price number | string kann null sein

one_time: crossed-out old price, higher than price. While a limited_offer runs, price is the crossed-out price instead; compare_at_price shows again when the offer ends.

Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
limited_offer object kann null sein

one_time: a lower price for a time. While it runs, the sales page and the checkout show price crossed out and the offer price. Times with a zone; convert the seller's local time with timezone from get_account_overview.
4 Felder anzeigen Felder ausblenden
- price number | string erforderlich
  
  Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
- starts_at string erforderlich
  
  Like 2026-11-26T23:00:00Z.
- ends_at string erforderlich
  
  Like 2026-11-30T22:59:00Z.
- countdown object kann null sein
  
  A countdown to ends_at on the sales page and the checkout while the offer runs (made by JavaScript in the browser). null = none. Left out = unchanged. An object replaces the whole countdown.
  4 Felder anzeigen Felder ausblenden
  
  style string erforderlich
  
  classic and slim: a bar at the top (sticky: it stays while buyers scroll). card_*: a box next to the price.
  
  Mögliche Werte: classicclassic_stickyslimslim_stickycard_classiccard_slimcard_special_1
  
  text string kann null sein
  
  Short text in the countdown, like "Launch price ends in".
  
  max. Länge 255
  
  color string
  
  Background, hex like #ff4400 (default).
  
  secondary_color string kann null sein
  
  Bars: the text color (default white). Cards: the card background (default #1a1a1a).
description_html string

Sales page text as HTML (p, h1-h4, strong, em, ul, ol, li, a, img, blockquote; a with class "button" is a button). The page always has its own buy button. A buy button in the text links to the url of the product + "/checkout" (create_product and get_product give url); there is no #buy anchor.

max. Länge 200000
checkout_description_html string

Extra text only on the checkout page, HTML. Not for external.

max. Länge 20000
checkout_banner_url string kann null sein

Banner image only on the checkout page, above the product title (it replaces the small product image). Recommended 1200 x 300 px. The image_url from finish_image, or a public image URL that Tentary copies. Not for external.

max. Länge 2048
images array of string

Product images on the sales page as https URLs: the image_url from finish_image (for an image on your disk), or a public image URL that Tentary copies (PNG, JPG, GIF, WebP, at most 10 MB). The first is the cover. YouTube links show as video. Replaces all images.

max. Länge 2048 max. Einträge 20
content array of object

download: what buyers get, in order. booking: what buyers get in addition to the appointment. Replaces all content.

max. Einträge 100
8 Felder anzeigen Felder ausblenden
- type string erforderlich
  
  text: formatted text. image: shows the image. video: an uploaded video in the player (streamed, converted some minutes after its first use). audio: an audio player. file: a download. video_embed: a YouTube, Vimeo or Loom video. button: a link button. image, video, audio and file need file_id. Type, name and description are stored with the file: one file shows the same way in every product and lesson.
  
  Mögliche Werte: textimagevideoaudiofilevideo_embedbutton
- html string
  
  text: the text as HTML (p, h1-h4, strong, em, ul, ol, li, a, img, blockquote). Placeholders for the buyer: %FIRST_NAME%, %FULL_NAME%, %EMAIL%, %PRODUCT_TITLE%, %VARIANT_TITLE%, %ORDER_ID%, %ACCESS_LINK[Text]%, %ACCESS_LINK_BUTTON[Text]%, %SELLER_NAME%, %SELLER_SUPPORT_EMAIL%; bookings also %ORDER_BOOKING_FROM%, %ORDER_BOOKING_TO%, %ORDER_BOOKING_ZOOM_LINK%.
  
  max. Länge 65535
- url string
  
  video_embed: YouTube, Vimeo or Loom link. button: the link target.
  
  max. Länge 2048
- label string
  
  button: the button text.
  
  max. Länge 250
- file_id integer
  
  image, video, audio, file: a file from upload_file, or a file_id from get_product or get_lesson content.
  
  min. 1
- name string
  
  image, video, audio, file: the name of the file (file: shown above the download).
  
  min. Länge 1 max. Länge 250
- description string
  
  file: plain text under the download. audio: the title above the player.
  
  max. Länge 65535
- folder string kann null sein
  
  Optional folder name. Blocks with the same folder show together. Not in lessons.
  
  max. Länge 250
link_url string kann null sein

link: the link that buyers get.

max. Länge 2048
access_text_html string kann null sein

link: text that buyers see after purchase. bundle: extra details for the buyers. HTML. Takes the placeholders of text blocks.

max. Länge 65535
bundle_items array of object kann null sein

bundle: the products that buyers get, from list_products (live or draft; no bundles or bookings). For a product with variants, give the variant_id of one variant. Replaces the list. Needed to go live.

max. Einträge 100
2 Felder anzeigen Felder ausblenden
- product_id integer erforderlich
  
  min. 1
- variant_id integer kann null sein
  
  Only for a product with variants.
  
  min. 1
external_url string kann null sein

external: where buyers buy it.

max. Länge 2048
course_id integer

course: the course that buyers get (from list_courses or create_course). Needed to go live.

min. 1
variants array of object kann null sein

download, link and course: options that buyers choose at checkout, each with its own name, price, stock and content (download: content, link: link_url and access_text_html, course: course_id). Replaces the list: a variant with id stays and changes (fields that you leave out stay), one without id is new, a variant that is not in the list is removed (its buyers keep access). [] or null removes all variants. With variants, price is the lowest variant price; billing must be one_time, without installment_plans, limited_offer and compare_at_price; a download product has no content of its own.

max. Einträge 50
8 Felder anzeigen Felder ausblenden
- id integer
  
  An existing variant (from get_product). Leave out for a new variant.
  
  min. 1
- name string
  
  Needed for a new variant.
  
  min. Länge 1 max. Länge 255
- price number | string
  
  Amount in the account currency, like 49 or 19.99. 0 = free. Needed for a new variant.
  
  min. 0 Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
- stock_limit integer kann null sein
  
  How many can be sold. null or 0 = no limit.
  
  min. 0
- content array of object
  
  download: what buyers of this variant get. Replaces its content.
  
  max. Einträge 100
  8 Felder anzeigen Felder ausblenden
  
  type string erforderlich
  
  text: formatted text. image: shows the image. video: an uploaded video in the player (streamed, converted some minutes after its first use). audio: an audio player. file: a download. video_embed: a YouTube, Vimeo or Loom video. button: a link button. image, video, audio and file need file_id. Type, name and description are stored with the file: one file shows the same way in every product and lesson.
  
  Mögliche Werte: textimagevideoaudiofilevideo_embedbutton
  
  html string
  
  text: the text as HTML (p, h1-h4, strong, em, ul, ol, li, a, img, blockquote). Placeholders for the buyer: %FIRST_NAME%, %FULL_NAME%, %EMAIL%, %PRODUCT_TITLE%, %VARIANT_TITLE%, %ORDER_ID%, %ACCESS_LINK[Text]%, %ACCESS_LINK_BUTTON[Text]%, %SELLER_NAME%, %SELLER_SUPPORT_EMAIL%; bookings also %ORDER_BOOKING_FROM%, %ORDER_BOOKING_TO%, %ORDER_BOOKING_ZOOM_LINK%.
  
  max. Länge 65535
  
  url string
  
  video_embed: YouTube, Vimeo or Loom link. button: the link target.
  
  max. Länge 2048
  
  label string
  
  button: the button text.
  
  max. Länge 250
  
  file_id integer
  
  image, video, audio, file: a file from upload_file, or a file_id from get_product or get_lesson content.
  
  min. 1
  
  name string
  
  image, video, audio, file: the name of the file (file: shown above the download).
  
  min. Länge 1 max. Länge 250
  
  description string
  
  file: plain text under the download. audio: the title above the player.
  
  max. Länge 65535
  
  folder string kann null sein
  
  Optional folder name. Blocks with the same folder show together. Not in lessons.
  
  max. Länge 250
- link_url string kann null sein
  
  link: the link that buyers of this variant get.
  
  max. Länge 2048
- access_text_html string kann null sein
  
  link: text that buyers of this variant see after purchase, HTML. Takes the placeholders of text blocks.
  
  max. Länge 65535
- course_id integer
  
  course: the course that buyers of this variant get. Needed for a new variant.
  
  min. 1
marketing_emails boolean

Subscribe buyers to the marketing e-mails (always on for newsletter).
ebook boolean

Treat as e-publication (e-book) for VAT.
pdf_stamp boolean

Stamp PDFs with the buyer's e-mail address.
login_protection boolean

Buyers must log in to open the product.
show_in_search boolean

Show the sales page in Google.
hide_in_shop boolean

Do not show the product on the shop page.
coupon_field boolean

Show the coupon field at checkout (default true).
stock_limit integer kann null sein

How many can be sold. null or 0 = no limit.

min. 0
buy_button_text string

Text of the buy button. Empty = default.

max. Länge 30
url_slug string kann null sein

Own URL part: shop URL/p/<url_slug>. Lowercase letters, digits and hyphens.

max. Länge 120
access_days integer kann null sein

Access ends this many days after purchase (3 to 9999). null or 0 = no end.

min. 0 max. 9999
access_starts_on string kann null sein

Buyers get access from this day at the earliest (for example the start of a program). Before it they wait. null = at once. Not for newsletter and external.

Muster ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
lead_magnet boolean

A free product that grows the e-mail list: buyers first confirm the marketing e-mails, then they get the product. Needs price 0 and billing one_time, and turns on marketing_emails. Not for newsletter, booking and external.
withdrawal_days integer

Withdrawal period shown at checkout.

Mögliche Werte: 01430
available_from string kann null sein

First day of sale.

Muster ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
available_until string kann null sein

Last day of sale.

Muster ^[0-9]{4}-[0-9]{2}-[0-9]{2}$

Antwort

Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.

The short form. get_product has all fields.

id integer

The ID.
name string

The name.
type string

The type.

Mögliche Werte: downloadlinknewsletterbookingcoursebundleexternal
status string

archived = deleted.

Mögliche Werte: livedraftarchived
url string<uri>

Sales page.
admin_url string<uri>

The page in the Tentary app.
note string

What to do next.