---
title: "POST /artifact-themes"
method: POST
path: "/artifact-themes"
tags: ["artifact-themes"]
---

# POST /artifact-themes

`POST /artifact-themes`

## Request

- Base URL: `https://YOUR_ORG_ID.gatana.ai/api/v1`
- URL: `https://YOUR_ORG_ID.gatana.ai/api/v1/artifact-themes`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token`

Create an organization theme for artifacts: the Gatana theme with the organization's colors, fonts and logo

## Request body

- CreateArtifactThemeBody
  - `name` string, required: Name shown in pickers and accepted by agents; unique in the organization, not 'gatana' or 'none'
  - `backgroundColor` string: Page background, as a hex color (#rgb or #rrggbb)
  - `textColor` string: Heading text; body text, lines and soft backgrounds are mixed from it and the background, as a hex color (#rgb or #rrggbb)
  - `accentColor` string: Buttons, links on hover, the eyebrow line and the gradient, as a hex color (#rgb or #rrggbb)
  - `headingFont` 'inter' | 'fraunces' | 'system-sans' | 'system-serif'
  - `bodyFont` 'inter' | 'fraunces' | 'system-sans' | 'system-serif'
  - `codeFont` 'jetbrains-mono' | 'system-mono': Font of code
  - `logo` string: Logo shown at the top of every page, as a base64 data: URL of a PNG, JPEG, WebP or SVG image of at most 256 KB, or an empty string for none
  - `extraCss` string: CSS added after the theme's own rules; the page's own styles still win over it

## Response `200`

Successful response

- ArtifactThemeDto
  - `id` string, required
  - `name` string, required
  - `backgroundColor` string, required: Lowercase hex color, #rrggbb
  - `textColor` string, required: Lowercase hex color, #rrggbb
  - `accentColor` string, required: Lowercase hex color, #rrggbb
  - `headingFont` 'inter' | 'fraunces' | 'system-sans' | 'system-serif', required
  - `bodyFont` 'inter' | 'fraunces' | 'system-sans' | 'system-serif', required
  - `codeFont` 'jetbrains-mono' | 'system-mono', required
  - `logo` string, required: The logo as a base64 data: URL, or empty when the theme has none
  - `extraCss` string, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Changes

- **2026-10-24** `8bae1eeac593`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gatana/apis/gatana/changes/artifact-themes/post.md)

---

[API](https://skmtc.dev/gatana/apis/gatana.md) - [All operations](https://skmtc.dev/gatana/apis/gatana/llms.txt) - [OpenAPI document](https://skmtc.dev/gatana/apis/gatana/revisions/2d7044033b1e?raw)