> ## 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}
GET /api/v1/evi/canvases
Authorization: Bearer theo_sk_...
```

返回經過身份驗證用戶的最多 50 個技能構建器，按最後更新時間排序。

**響應**

```json theme={null}
{
  "canvases": [
    {
      "id": "uuid",
      "name": "My Agent",
      "description": "A customer service agent",
      "status": "draft",
      "graphJson": { "nodes": [], "edges": [] },
      "compiledManifest": null,
      "isPublic": false,
      "publishedSkillId": null,
      "createdAt": "2026-04-15T00:00:00Z",
      "updatedAt": "2026-04-15T00:00:00Z"
    }
  ]
}
```

## 創建技能構建器

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

{
  "name": "My Agent",
  "description": "Optional description",
  "graph_json": {
    "nodes": [],
    "edges": []
  }
}
```

**參數**

* `name`（string，必需）— 技能構建器名稱（最多 128 個字符）。
* `description`（string，可選）— 簡短描述（最多 500 個字符）。
* `graph_json`（object，可選）— 初始圖結構，包含 `nodes` 和 `edges` 數組，默認為空。

## 獲取技能構建器

```http theme={null}
GET /api/v1/evi/canvases/{id}
Authorization: Bearer theo_sk_...
```

根據 ID 返回單個技能構建器。只有該技能構建器的所有者才能訪問它。

## 更新技能構建器

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

{
  "name": "Updated Name",
  "graph_json": { "nodes": [...], "edges": [...] }
}
```

所有字段均為可選，但必須至少提供一個字段。

**參數**

* `name`（string，可選）
* `description`（string，可選）
* `graph_json`（object，可選）
* `is_public`（boolean，可選）

## 刪除技能構建器

```http theme={null}
DELETE /api/v1/evi/canvases/{id}
Authorization: Bearer theo_sk_...
```

永久刪除該技能構建器。如果曾從中發佈過技能，該技能仍會保留，但不再與之關聯。


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