---
title: "Update a template listing"
method: PATCH
path: "/v1/templates/{listing_id}"
tags: ["templates"]
---

# Update a template listing

`PATCH /v1/templates/{listing_id}`

## Request

- Base URL: `https://api.framelane.io`
- URL: `https://api.framelane.io/v1/templates/{listing_id}`
- Auth: HTTP bearer

Admin workspaces only. Send only the fields that change; null clears an optional one. A listing that ends up published is checked like a new one.

## Path parameters

- `listing_id` string, required

## Request body

- TemplateListingUpdate: Send only the fields that change; null clears an optional field.
  - `slug` string, nullable
  - `title` string, nullable
  - `description` string, nullable
  - `category` string, nullable
  - `tags` string[], nullable
  - `priority` integer, nullable
  - `premium` boolean, nullable
  - `status` 'draft' | 'published', nullable
  - `preview_url` string, uri, nullable
  - `family` string, nullable

## Response `200`

Successful Response

- TemplateListingOut: A gallery listing as stored.
  - `id` string, required: Listing id.
  - `project_id` string, required: The listed template project.
  - `slug` string, required
  - `title` string, required
  - `description` string, nullable
  - `category` string, nullable
  - `tags` string[]
  - `priority` integer, required
  - `premium` boolean, required
  - `status` 'draft' | 'published', required
  - `preview_url` string, nullable
  - `published_at` string, date-time, nullable
  - `family` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: admin_only: not an admin workspace.
- `404`: Listing not found.
- `409`: The slug is taken.
- `422`: template_assets_not_shared or template_has_webhook when the result is published.

---

[API](https://skmtc.dev/framelane/apis/framelane-api.md) · [All operations](https://skmtc.dev/framelane/apis/framelane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/framelane/apis/framelane-api/revisions/a223001ca8e5?raw)