> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 發佈畫布

> 編譯併發布技能構建器畫布，將其作為技能發佈，並設置可配置的可見性。

```http theme={null}
POST /api/v1/evi/canvases/{id}/publish
Authorization: Bearer theo_sk_...
Content-Type: application/json

{
  "slug": "my-support-agent",
  "version": "1.0.0",
  "author": { "name": "Your Name" },
  "visibility": "public",
  "readme": "# My Support Agent\nA customer service skill built with the Skill Builder.",
  "license": "MIT",
  "keywords": ["support", "customer-service"]
}
```

編譯畫布、運行自動化審核檢查，並將其發佈為技能。該技能會進入與通過 CLI 或 API 提交的技能相同的審核流程。

## 參數

* `slug`（字符串，必填）— 技能 slug。僅限小寫字母數字及連字符。
* `version`（字符串，必填）— 語義化版本號（例如 `1.0.0`）。
* `author`（對象，必填）— `{ name, email?, url? }`。
* `visibility`（字符串，可選）— 發佈可見性。默認值：`"private"`。
  * `"private"` — 僅你本人可見並可安裝該技能。
  * `"org"` — 對目標組織的所有成員可見。需要提供 `target_org_id`。
  * `"public"` — 在公共技能商店中列出。
* `target_org_id`（字符串，可選）— 當 `visibility` 為 `"org"` 時必填。目標組織的 UUID。
* `readme`（字符串，可選）— 用於市場列表展示的 Markdown README（最多 50,000 字符）。
* `license`（字符串，可選）— SPDX 許可證標識符。默認值：`"MIT"`。
* `keywords`（數組，可選）— 最多 10 個搜索關鍵詞。

## 響應（自動通過）

```json theme={null}
{
  "published": true,
  "visibility": "public",
  "submission": {
    "id": "uuid",
    "status": "approved",
    "reviewTier": "auto",
    "autoApproved": true
  },
  "skillId": "uuid"
}
```

## 響應（待審核）

```json theme={null}
{
  "published": true,
  "visibility": "org",
  "submission": {
    "id": "uuid",
    "status": "pending_review",
    "reviewTier": "staff",
    "autoApproved": false
  },
  "skillId": "uuid"
}
```

## 響應（編譯或審核失敗）

返回狀態碼 `422`，`published` 為 `false`，並附帶描述失敗原因的 `errors` 或 `review` 對象。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.