> ## 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.