# Finish image

`POST https://api.tentary.com/v1/images/{upload_id}/finish`

Source: https://tentary.com/de/help/api/finish-image/
Area: Produkte und Dateien
MCP tool: `finish_image`. Changes data at once.

---

The last step of [`POST /v1/images`](https://tentary.com/de/help/api/upload-image/), 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`](https://tentary.com/de/help/api/create-product/) and [`PATCH /v1/products/{product_id}`](https://tentary.com/de/help/api/update-product/)
- `cover_image_url` of [`POST /v1/courses`](https://tentary.com/de/help/api/create-course/) and [`PATCH /v1/courses/{course_id}`](https://tentary.com/de/help/api/update-course/) (course banner)
- `cover_image_url` of [`POST /v1/courses/{course_id}/modules`](https://tentary.com/de/help/api/create-module/) and [`PATCH /v1/modules/{module_id}`](https://tentary.com/de/help/api/update-module/) (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`](https://tentary.com/de/help/api/upload-file/) instead.

## Authorization

`Authorization: Bearer <API key>`

A personal API key (tnt_...). Create it in the Tentary app on the page AI & API.

## Path parameters

- `upload_id` (string, required, path): The upload_id from upload_image. Limits: maxLength 250.

## Response

- `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.

## Example request

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

## Example response

```json
{
  "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)."
}
```