Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
PUT /v1/skills/{skill_id}
指定された Skill のメタデータ（名前、説明など）を更新します。JSON リクエストボディのみサポートし、メタデータフィールドの修正に使用します。新規ファイルのアップロードはサポートしません。
パスパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|
skill_id | string | はい | Skill の一意識別子 |
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|
| Authorization | はい | Bearer $QODER_PAT |
| Content-Type | はい | application/json |
リクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|
name | string | いいえ | 新しい Skill 名 |
description | string | いいえ | 新しい Skill の説明 |
リクエスト例
curl -X PUT https://openapi.qoder.sh/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"name": "updated-skill-name",
"description": "更新後の Skill の説明"
}'
レスポンス例
HTTP 200 OK
{
"id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
"type": "skill",
"name": "updated-skill-name",
"description": "更新後の Skill の説明",
"skill_type": "custom",
"status": "active",
"version": 1,
"content_size": 309,
"content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
"metadata": {},
"created_at": "2026-05-18T15:35:24.248164Z",
"updated_at": "2026-05-18T15:36:01.767469Z"
}
レスポンスについて
updated_at フィールドは操作時刻に更新されます- メタデータ更新では
version はインクリメントされません（内容変更時のみインクリメント）
- 提供されないフィールドは元の値のまま変更されません
エラーレスポンス
| HTTP | type | 説明 |
|---|
| 400 | invalid_request_error | JSON ではなく multipart 使用: "Request body must be valid JSON." |
| 401 | TOKEN_INVALID | 認証トークンが欠落または無効 |
| 404 | not_found_error | Skill が存在しないまたは削除済み |
注意事項
- PUT エンドポイントは
application/json Content-Type のみ受け付けます
- メタデータ更新のみに使用し、新規 zip ファイルのアップロードはサポートしません
- Skill 内容ファイルを更新するには、
POST /v1/skills で再作成する必要があります
