API 创建组织 Skill

支持在指定组织下创建组织级 Skill，可以通过该接口，在指定组织下创建组织级 Skill。

仅接受 .skill、.zip；压缩包最大 20 MiB。
包内根目录或唯一顶层目录下必须包含 SKILL.md，且 frontmatter 必须包含 name。
创建成功后，使用 POST /v1/org/skill/update 并在 Form Data 中传入 skill_id 更新该 Skill。

请求方式

POST

调用地址

https://api.${endpoint}/v1/org/skill/create

调用验证

使用账号级 DevKey / DevSecret 的 Basic 鉴权，并要求调用账号具备组织 Skill 创建权限。

请求

请求示例

curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'org_id=org-xxxx' \ -F 'file=@/path/to/refund-policy.skill'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'org_id=org-xxxx' \
  -F 'file=@/path/to/refund-policy.skill'

此代码块在浮窗中显示

请求头

字段	类型	说明
Authorization	Basic ${BASIC_TOKEN}	使用 `DevKey:DevSecret` Base64 后的 Basic Token。
Content-Type	application/json	请求体格式。

请求参数（Body Parameters）

参数	类型	必填	说明
`org_id`	String	是	要创建共享 Skill 的组织 ID。
`file`	File	是	`.skill` 或 `.zip` 技能包。

响应

响应示例

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "owner_type": "ORGANIZATION" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "owner_type": "ORGANIZATION"
  }
}

此代码块在浮窗中显示

成功响应

字段	类型	说明
skill_id	String	新建 Skill ID。
name	String	Skill 名称。
owner_type	String	Skill 归属类型。

失败响应

字段	类型	说明
code	Integer	错误码。
message	String	错误详情。

状态码

状态码	说明
200	成功
400	参数错误
401	未授权
403	权限不足
429	请求过于频繁
500	服务器错误