---
title: "Update a theme"
method: PATCH
path: "/themes/{id}"
tags: ["Theme"]
---

# Update a theme

`PATCH /themes/{id}`

## Request

- Base URL: `https://telescope.ac/api`
- URL: `https://telescope.ac/api/themes/{id}`
- Auth: none declared

Updates a theme's title, description or customization blob. Author only.

**API credit cost:** 2

## Path parameters

- `id` string, uuid, required: ID of the theme to update.

## Headers

- `Authorization` string

## Request body

- PatchThemeInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `css` string: Replace the theme stylesheet (pro only).
  - `customization` SpaceCustomization
    - `accent_color` string, nullable
    - `background_color` string, nullable
    - `blog_layout_data` object
    - `blog_layout_style` string, nullable
    - `branding_icon_file_id` string, uuid
    - `content_width` string, nullable
    - `corner_radius` string, nullable
    - `custom_css` string, nullable
    - `dark_theme_background_color` string, nullable
    - `dark_theme_header_color` string, nullable
    - `dark_theme_header_text_color` string, nullable
    - `dark_theme_mode` string, nullable
    - `dark_theme_tabs_text_color` string, nullable
    - `dark_theme_text_color` string, nullable
    - `font` string, nullable
    - `font_size` string, nullable
    - `header_color` string, nullable
    - `header_data` object
    - `header_text_color` string, nullable
    - `image_file_id` string, uuid
    - `line_height` string, nullable
    - `publication_content_width` string, nullable
    - `publication_data` object
    - `text_color` string, nullable
    - `title_font` string, nullable
    - `title_font_size` string, nullable
    - `title_font_weight` string, nullable
  - `description` string: Change description.
  - `title` string: Change display title.

## Response `200`

OK

- ThemeOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `theme` Theme, required
    - `contract_version` integer, required
    - `created_at` string, date-time, nullable, required
    - `css` string, required
    - `customization` Jsonb, required
    - `deleted_at` string, date-time
    - `description` string, required
    - `id` string, uuid, required
    - `status` 'private' | 'listed', required
    - `title` string, required
    - `updated_at` string, date-time, nullable, required
    - `user_id` string, uuid, required

## Other responses

- `default`: Error

---

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