---
title: "更新团队 Skill"
method: PUT
path: "/api/v1/teams/skills/{skill_id}"
tags: ["【Team 管理员】Skill 管理"]
---

# 更新团队 Skill

`PUT /api/v1/teams/skills/{skill_id}`

请求参数的 content 非空时，后端将 SKILL.md 重新打包上传 OSS 并创建新的 agent_skill_versions 并切到 active version 到新版本，否则仅更新当前版本的 description / tags / is_force_delivery / group_ids

## Path parameters

- `skill_id` string, required

## Request body

- DomainUpdateTeamSkillReq
  - `content` string
  - `description` string
  - `group_ids` string[]
  - `is_force_delivery` boolean
  - `name` string — 当前不允许改 name(unique 索引硬约束),保留位
  - `skill_md_path` string
  - `source_label` string
  - `source_type` string
  - `tags` string[]

## Response `200`

成功

- object
  - `code` integer
  - `data` DomainTeamSkill
    - `active_version` string
    - `categories` string[]
    - `content` string — SKILL.md 文本,从 active version 当时入库时记录
    - `created_at` integer
    - `description` string
    - `enabled` boolean
    - `groups` DomainSkillGroupRef[]
      - `id` string
      - `name` string
    - `id` string
    - `is_force_delivery` boolean
    - `name` string
    - `s3_key` string
    - `skill_md_path` string
    - `source_label` string
    - `source_type` string
    - `tags` string[]
    - `updated_at` integer
  - `message` string

## Other responses

- `401` — 未授权
- `500` — 服务器内部错误

---

[API](https://skmtc.net/chaitin/apis/untitled-api.md) · [All operations](https://skmtc.net/chaitin/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chaitin/untitled-api/revisions/5a5929cb17f2/schema)