Atualizar skill - Qoder CN Series: Central de Documentação do Alibaba Cloud

Atualize os metadados ou o conteúdo da Skill especificada.

PUT /api/v1/cloud/skills/{skill_id}

Atualize os metadados ou o conteúdo da Skill especificada. O sistema aceita apenas corpos de requisição JSON.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`
`Content-Type`	Sim	`application/json`

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`skill_id`	string	Sim	Identificador exclusivo da Skill

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
`name`	string	Não	Novo nome da Skill (máximo de 64 caracteres). Admite apenas letras minúsculas, dígitos, hifens e underscores. Deve começar com letra ou dígito.
`description`	string	Não	Nova descrição da Skill
`content`	string	Não	Novo conteúdo da Skill. Se `content_encoding` for `"base64"`, forneça um arquivo zip codificado em base64 contendo `SKILL.md`. Caso contrário, o sistema armazena o valor como texto simples.
`content_encoding`	string	Não	Defina como `"base64"` quando `content` for um arquivo zip codificado em base64
`metadata`	object	Não	Metadados personalizados. Substitui o objeto de metadados armazenado atualmente.

Exemplo de requisição

curl -X PUT "https://api.qoder.com.cn/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "updated-skill-name",
    "description": "Updated Skill description",
    "metadata": {"team":"docs","stage":"updated"}
  }'

Exemplo de resposta

HTTP 200 OK

{
  "id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
  "type": "skill",
  "display_title": "updated-skill-name",
  "description": "Updated Skill description",
  "source": "custom",
  "latest_version": "1",
  "metadata": {
    "team": "docs",
    "stage": "updated"
  },
  "created_at": "2026-05-18T15:35:24.248164Z",
  "updated_at": "2026-05-18T15:36:01.767469Z"
}

Observações sobre a resposta

O campo updated_at assume o horário da operação.
Atualize content incrementa latest_version.
Alterar apenas os metadados não incrementa latest_version.
Campos omitidos na requisição mantêm os valores atuais.

Erros

HTTP	type	Condição
400	`invalid_request_error`	Uso de multipart em vez de JSON: `Request body must be valid JSON.`
401	`authentication_error`	Token de autenticação ausente ou inválido
404	`not_found_error`	A Skill não existe ou não está mais acessível

Observações

O endpoint PUT aceita apenas o Content-Type application/json.
O conteúdo zip em base64 deve incluir SKILL.md no diretório raiz ou de primeiro nível.
Se o frontmatter do SKILL.md no zip base64 definir name ou description e o corpo da requisição omitir esses campos, a API usará os valores do frontmatter.

Para a especificação completa do envelope de erros, consulte Referência de erros.