---
title: "Post Workspace Theme"
method: POST
path: "/api/v1/entities/workspaces/{workspaceId}/workspaceThemes"
tags: ["Appearance"]
---

# Post Workspace Theme

`POST /api/v1/entities/workspaces/{workspaceId}/workspaceThemes`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/entities/workspaces/{workspaceId}/workspaceThemes`
- Auth: none declared

## Path parameters

- `workspaceId` string, required

## Query parameters

- `metaInclude` string[]: Included meta objects

## Request body

- JsonApiWorkspaceThemeInDocument
  - `data` JsonApiWorkspaceThemeIn, required: JSON:API representation of workspaceTheme entity.
    - `attributes` object, required
      - `content` object, required: Free-form JSON content. Maximum supported length is 15000 characters.
      - `name` string, required
    - `id` string, required: API identifier of an object
    - `type` 'workspaceTheme', required: Object type

## Response `201`

Request successfully processed

- JsonApiWorkspaceThemeOutDocument
  - `data` JsonApiWorkspaceThemeOut, required: JSON:API representation of workspaceTheme entity.
    - `attributes` object, required
      - `content` object, required: Free-form JSON content. Maximum supported length is 15000 characters.
      - `name` string, required
    - `id` string, required: API identifier of an object
    - `meta` object
      - `origin` object
        - `originId` string, required: defines id of the workspace where the entity comes from
        - `originType` 'NATIVE' | 'PARENT', required: defines type of the origin of the entity
    - `type` 'workspaceTheme', required: Object type
  - `links` ObjectLinks
    - `self` string, uri, required: A string containing the link's URL.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)