---
title: "导入主题包"
method: POST
path: "/theme-packs"
tags: ["主题包"]
---

# 导入主题包

`POST /theme-packs`

接收 .songloft-theme JSON 内容，验证后存入。相同 ID 的主题包会被更新。

## Request body

- object

## Response `200`

导入成功

- ServicesThemePackResponse
  - `author` string
  - `created_at` string
  - `data` ModelsThemePackData
    - `author` string
    - `cardRadius` number
    - `controlRadius` number
    - `dark` ModelsThemePackColors
      - `backgroundColor` string
      - `glassColor` string — GlassColor independently drives the Liquid Glass decorative tint (--glass-glow / --glass-glow-faint / --glass-sheen in the Lynx client), separate from SeedColor which drives the button/accent channel. Optional: when absent the client falls back to its star-blue glass baseline, so glass stays a different colour from buttons (true dual-channel). Existing packs without this field still validate.
      - `seedColor` string
      - `surfaceColor` string
    - `description` string
    - `id` string
    - `light` ModelsThemePackColors
      - `backgroundColor` string
      - `glassColor` string — GlassColor independently drives the Liquid Glass decorative tint (--glass-glow / --glass-glow-faint / --glass-sheen in the Lynx client), separate from SeedColor which drives the button/accent channel. Optional: when absent the client falls back to its star-blue glass baseline, so glass stays a different colour from buttons (true dual-channel). Existing packs without this field still validate.
      - `seedColor` string
      - `surfaceColor` string
    - `name` string
    - `navigationRadius` number
    - `navigationStyle` string
    - `playerGradient` string[]
    - `schemaVersion` integer
    - `version` string
  - `description` string
  - `id` integer
  - `name` string
  - `schema_version` integer
  - `theme_id` string
  - `updated_at` string
  - `version` string

## Other responses

- `400` — 格式错误

## Changes

- **2026-08-03** `292142d0b7ee` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/theme-packs/post.md)

---

[API](https://skmtc.dev/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.dev/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/revisions/5b1368253f6c/schema)