# Update landing page

`PATCH https://api.tentary.com/v1/landing-pages/{page_id}`

Source: https://tentary.com/de/help/api/update-landing-page/
Area: Landingpages
MCP tool: `update_landing_page`. Changes data at once.

---

Changes the fields that you send of an `html` landing page. All other fields stay.

- `html` replaces the whole page. Call [`GET /v1/landing-pages/{page_id}`](https://tentary.com/de/help/api/get-landing-page/) first.
- Pages of type `builder` can only change in the Tentary app.

To delete a page, use [`POST /v1/delete`](https://tentary.com/de/help/api/delete-item/).

## Authorization

`Authorization: Bearer <API key>`

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

## Path parameters

- `page_id` (integer, required, path): The id from list_landing_pages. Limits: min 1.

## Request body

- `title` (string): Name in the Tentary app (not the <title> of the page). Limits: maxLength 255.
- `url_slug` (string): The page address: shop URL/<url_slug>. Lowercase letters, digits and hyphens. Default from the title. A url_slug of another landing page gives an error. A new url_slug does not redirect: the old address then opens the shop. Limits: maxLength 120.
- `html` (string): The full HTML document, served as it is (at most 900 KB). A newsletter sign-up form: put data-tentary="subscribe" on the <form> tag and an <input type="email"> in it, with no JavaScript for the form. Right after the form, outside it, add one element with data-tentary="subscribed" that holds the confirmation text; Tentary shows it after the sign-up (do not hide or show it with your own code). Only for a separate thank-you page, add data-tentary-return="/its-address" on the <form> tag. Link to products with their shop URL from list_products. Limits: maxLength 900000.
- `status` (string): live = public at its URL. draft = not public (the URL opens the shop). Allowed values: `draft`, `live`.
- `affiliates` (boolean): Show the page to the seller's affiliates in their affiliate hub, with their affiliate ID attached.

## Response

- `id` (integer): The ID.
- `title` (string): Name in the Tentary app.
- `type` (string): html = own HTML code. builder = made with the page builder in the app. Allowed values: `html`, `builder`.
- `status` (string): draft = not public: its URL opens the shop. Allowed values: `live`, `draft`.
- `url_slug` (string): The address part of the URL.
- `url` (string<uri>): shop URL/<url_slug>.
- `affiliates` (boolean): true = shown to the affiliates in their affiliate hub.
- `created_at` (string<date-time>, can be null): UTC, like 2026-01-31T14:05:00Z.
- `admin_url` (string<uri>): The page in the Tentary app.

## Example request

```bash
curl -X PATCH "https://api.tentary.com/v1/landing-pages/902" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "live"
}'
```

## Example response

```json
{
  "id": 902,
  "title": "Free stretching guide",
  "type": "html",
  "status": "live",
  "url_slug": "stretching-guide",
  "url": "https://lena-yoga.mytentary.com/stretching-guide",
  "affiliates": false,
  "created_at": "2026-10-27T08:51:48Z",
  "admin_url": "https://app.tentary.com/landingpages/edit-html/902"
}
```