Products and files

Finish image

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 / images / {upload_id} / finish

The last step of POST /v1/images, after your PUT to the upload_url. Checks the image, publishes it and returns its image_url. Use the image_url for:

images or checkout_banner_url of POST /v1/products and PATCH /v1/products/{product_id}
cover_image_url of POST /v1/courses and PATCH /v1/courses/{course_id} (course banner)
cover_image_url of POST /v1/courses/{course_id}/modules and PATCH /v1/modules/{module_id} (module image, 16:9, shows only with the course layout "cards")
img src in HTML: email body_html, text blocks and landing pages

An image block in content needs a file_id from POST /v1/files instead.

Changes at once MCP tool finish_image

curl -X POST "https://api.tentary.com/v1/images/2c83c3215660ad75ee567ef4fa2d6289.png/finish" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/images/2c83c3215660ad75ee567ef4fa2d6289.png/finish", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/images/2c83c3215660ad75ee567ef4fa2d6289.png/finish",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/images/2c83c3215660ad75ee567ef4fa2d6289.png/finish');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "image_url": "https://img.tentary.com/2c83c3215660ad75ee567ef4fa2d6289.png",
  "size_bytes": 70,
  "next_step": "Use image_url in images or checkout_banner_url (products), cover_image_url (courses and modules) or as img src in HTML (e-mails, text blocks, landing pages)."
}

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

upload_id string required

The upload_id from upload_image.

max length 250 Example: "2c83c3215660ad75ee567ef4fa2d6289.png"

Response

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

image_url string<uri>

Use it in images, checkout_banner_url, cover_image_url or as img src in HTML.
size_bytes integer

File size in bytes.
next_step string

What to do next.