Products and files

Upload 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

Uploads an image from your disk for a sales page, course, module, email or landing page: PNG, JPG, GIF or WebP, at most 10 MB.

Send file_name and size_bytes. The answer has an upload_url.
Send the bytes there with HTTP PUT.
Call POST /v1/images/{upload_id}/finish with the upload_id.

An image that is already at a public URL needs no upload: put the URL into images directly. For files that buyers get, use POST /v1/files.

Changes at once MCP tool upload_image

curl -X POST "https://api.tentary.com/v1/images" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file_name": "cover.png",
  "size_bytes": 68
}'

const response = await fetch("https://api.tentary.com/v1/images", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "file_name": "cover.png",
    "size_bytes": 68
  }),
});
const data = await response.json();

import os
import requests

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

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

200 · Response

{
  "upload_id": "2c83c3215660ad75ee567ef4fa2d6289.png",
  "upload_url": "https://tentary-files.s3.eu-central-1.amazonaws.com/image-uploads/7/2c83c3215660ad75ee567ef4fa2d6289.png?X-Amz-Expires=1200&X-Amz-Signature=3f9a2c71e0b4",
  "method": "PUT",
  "expires_in_seconds": 1200,
  "next_step": "Send the image bytes with HTTP PUT to upload_url (no extra headers), for example: curl -T <file> \"<upload_url>\". Then call finish_image with upload_id."
}

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

file_name string required

Name with extension, like "cover.png".

max length 250
size_bytes integer required

The exact file size.

min 1 max 10485760

Response

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

upload_id string

Call finish_image with it after the PUT.
upload_url string<uri>

Send the bytes here with HTTP PUT, without extra headers.
method string

The HTTP method for the upload.

Allowed values: PUT
expires_in_seconds integer

The upload_url works this long.
next_step string

What to do next (PUT, then finish_image).