Products and files

Upload file

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 / files

Stores a file that buyers get, as content of a product or a lesson: for example a PDF, ZIP, video, audio or image. For images on a sales page, use POST /v1/images or put a URL into images.

There are two ways:

Upload with PUT (preferred, up to 5 GB). Send file_name and size_bytes without url. The answer has an upload_url. Send the bytes there with HTTP PUT, for example with curl, then call POST /v1/files/{file_id}/finish.
Copy from a URL (up to 10 MB). Send url, and Tentary copies the file from the public https URL at once. No finish step is needed. Use this only if you cannot send a PUT.

Larger files without PUT: the account owner uploads them in the Tentary app.

Then add the file to a content block of PATCH /v1/products/{product_id}, POST /v1/courses/{course_id}/lessons or PATCH /v1/lessons/{lesson_id}, for example {"type": "video", "file_id": ...}.

Block types image, video and audio show the file in a player. Type file gives a download, also for a video or an image.
kind in the answer is the block type that fits the file.
Videos in a video block are converted for streaming. This takes some minutes.

See File uploads.

Changes at once MCP tool upload_file

curl -X POST "https://api.tentary.com/v1/files" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file_name": "Workbook.pdf",
  "size_bytes": 2483011
}'

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

import os
import requests

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

<?php
$ch = curl_init('https://api.tentary.com/v1/files');
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' => 'Workbook.pdf',
        'size_bytes' => 2483011,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "file_id": 601,
  "upload_url": "https://tentary-files.s3.eu-central-1.amazonaws.com/files/workbook_4856795675118855267-1793091108.pdf?X-Amz-Expires=1200&X-Amz-Signature=3f9a2c71e0b4",
  "method": "PUT",
  "expires_in_seconds": 1200,
  "next_step": "Send the file bytes with HTTP PUT to upload_url (no extra headers), for example: curl -T <file> \"<upload_url>\". Then call finish_upload with file_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

url string

Public https URL of the file (at most 10 MB).

max length 2048
file_name string

Name with extension, like "Workbook.pdf". With url: optional (default from the URL).

max length 250
size_bytes integer

Without url: the exact file size.

min 1 max 5368709120

Response

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

Without url: the upload_url for the PUT. With url: the stored file.

Variant 1 of 2

file_id integer

Call finish_upload 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_upload).

Variant 2 of 2

file_id integer

Use it in a content block.
name string

The name.
file_type string

File extension, like pdf.
kind string

The content block type that fits the file.

Allowed values: imagevideoaudiofile
size_bytes integer

File size in bytes.