---
title: "Update a space"
method: PATCH
path: "/spaces/{id}"
tags: ["Space"]
---

# Update a space

`PATCH /spaces/{id}`

## Request

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

Updates a space.

**API credit cost:** 3

## Path parameters

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

## Headers

- `Authorization` string

## Request body

- PatchSpaceWithExtrasInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `custom_domains` PatchedCustomDomain[]
    - `host` string, hostname, required: Domain hostname.
    - `id` string, uuid, nullable: ID of existing domain to update (omit to create new).
    - `is_set_as_default` boolean: Set as the default domain for this space.
  - `space` PatchedSpace, required
    - `alt` string: Rename URL slug.
    - `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
    - `footer_text` string: Footer text shown on publications.
    - `language` string: Default content language (ISO 639-1).
    - `metadata` SpaceMetadata
      - `seo` SpaceMetadataSEO
        - `description` string, nullable
        - `include_canonical` boolean, nullable
        - `keywords` string, nullable
        - `lang` string, nullable
        - `noindex_nofollow` boolean, nullable
        - `remove_noref_noopener` boolean, nullable
    - `subscriptions_enabled` boolean: Allow readers to subscribe to this space.
    - `text` string: Space description text.
    - `title` string: Change display title.
    - `topic_ids` string[]: Replace topic IDs.
  - `space_categories` PatchedSpaceCategory[]
    - `alt` string, required: URL slug for the category.
    - `id` string, uuid, nullable: ID of existing category to update (omit to create new).
    - `title` string, required: Display title.

## Response `200`

OK

- PatchSpaceOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `space` SpaceWithRelatedData, required
    - `alt` string, required
    - `branding_icon_file_url` string
    - `created_at` string, date-time, nullable, required
    - `custom_domains` CustomDomain[], nullable
      - `created_at` string, date-time, nullable, required
      - `deleted_at` string, date-time
      - `host` string, required
      - `id` string, required
      - `set_as_default_at` string, nullable, required
      - `space_id` string, required
      - `updated_at` string, date-time, nullable, required
    - `customization` Jsonb, required
    - `deleted_at` string, date-time
    - `featured_at` string, date-time
    - `footer_text` string, required
    - `id` string, uuid, required
    - `image_file_url` string
    - `language` string, required
    - `metadata` Jsonb, required
    - `publications` PublicationWithDraft[], nullable
      - `alt` string, required
      - `cover_image_url` string
      - `created_at` string, date-time
      - `deleted_at` string, date-time
      - `description` string
      - `flagged_at` string, date-time
      - `id` string, uuid
      - `language` string, required
      - `metadata` Jsonb, required
      - `published_at` string, nullable, required
      - `published_draft_id` string, uuid
      - `space_category_id` string, uuid
      - `space_id` string, uuid
      - `spam_reasons` string
      - `spam_score` integer
      - `text` string
      - `title` string
      - `topic_ids` Jsonb
      - `translations` PublicationTranslationContent[], nullable
        - `cover_image_url` string
        - `description` string
        - `id` string, uuid, required
        - `language` string, required
        - `text` string
        - `title` string
      - `update_published_at` string
      - `updated_at` string, date-time
      - `user_id` string, uuid, required
    - `space_categories` SpaceCategory[], nullable
      - `alt` string, required
      - `created_at` string, date-time, nullable, required
      - `deleted_at` string, date-time
      - `id` string, required
      - `space_id` string, required
      - `title` string, required
      - `updated_at` string, date-time, nullable, required
    - `subscriptions_enabled` boolean, required
    - `text` string, required
    - `theme_id` string, uuid
    - `title` string, required
    - `topic_ids` Jsonb
    - `updated_at` string, date-time, nullable, required
    - `user_id` string, uuid

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