Products and files

Finish upload

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

The last step of POST /v1/files without url, after your PUT to the upload_url. Checks that the file is stored and makes it usable. Returns the file_id, name and size.

Changes at once MCP tool finish_upload

curl -X POST "https://api.tentary.com/v1/files/601/finish" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/files/601/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/files/601/finish",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/files/601/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

{
  "file_id": 601,
  "name": "Workbook",
  "file_type": "pdf",
  "kind": "file",
  "size_bytes": 2483011
}

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

file_id integer required

The file_id from upload_file.

min 1 Example: 601

Response

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

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.