---
title: "Apply a theme to a space"
method: POST
path: "/spaces/{id}/theme"
tags: ["Theme", "Space"]
---

# Apply a theme to a space

`POST /spaces/{id}/theme`

## Request

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

Copies the theme's customization into the space through the normal customization write path. Parts the caller's plan does not allow are skipped; the response reports what was applied.

**API credit cost:** 5

## Path parameters

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

## Headers

- `Authorization` string

## Request body

- ApplyThemeInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `theme_id` string, uuid, required: ID of the theme to apply.

## Response `200`

OK

- ApplyThemeOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `applied` ThemeApplyReport, required
    - `advanced` boolean, required: Colors, layout, images, dark theme were applied.
    - `basic` boolean, required: Fonts and text sizing were applied.
    - `css` boolean, required: The theme's custom CSS was applied.

## 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)