Skill の取得

GET /api/v1/cloud/skills/{skill_id} ID を指定して単一の Skill の詳細を取得します。

パスパラメータ

パラメータ	型	必須	説明
`skill_id`	string	はい	Skill の一意識別子

クエリパラメータ

パラメータ	型	必須	説明
`include_content`	boolean	いいえ	⚠️ 非推奨：`true` にすると base64 エンコードされた Skill 内容を `content` に含めます（代わりに Skill バージョン内容のダウンロード `GET /skills/{skill_id}/versions/{version}/content` を使用）

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT or SAT>`

リクエスト例

curl -X GET https://api.qoder.com/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
  "type": "skill",
  "display_title": "test-skill-api-doc",
  "source": "custom",
  "latest_version": "1759178010641129",
  "metadata": {
    "team": "docs"
  },
  "created_at": "2026-05-18T15:35:24.248164Z",
  "updated_at": "2026-05-18T15:35:24.248164Z"
}

レスポンスフィールド

レスポンスは Skill オブジェクトです。

フィールド	型	説明
`id`	string	`skill_` プレフィックス付きの Skill 一意識別子
`type`	string	固定値 `"skill"`
`display_title`	string	表示タイトル
`source`	string	Skill のソース：`custom` または `qoder`
`latest_version`	string \| null	最新バージョン番号。すべてのバージョンが削除されると `null`
`metadata`	object	Skill に保存されるカスタムメタデータオブジェクト。デフォルトは `{}`
`description`	string	⚠️ 非推奨：Skill の説明（代わりに Skill バージョンの取得でバージョンオブジェクトの `description` を使用）
`content`	string	⚠️ 非推奨：base64 エンコードされた内容。`include_content=true` の場合のみ返されます（代わりに Skill バージョン内容のダウンロードを使用）
`content_encoding`	string	⚠️ 非推奨：`content` とともに返され、値は `"base64"`（代替は上記と同じ）
`created_at`	string	作成時刻（ISO 8601）
`updated_at`	string	最終更新時刻（ISO 8601）

エラーレスポンス

HTTP	type	説明
401	`TOKEN_INVALID`	認証トークンが欠落または無効
404	`not_found_error`	Skill が存在しないまたはアクセス不可: "Skill '{skill_id}' was not found."

完全なエラーエンベロープについてはエラーを参照してください。

Agent スキル

Agent にドメインの専門知識を付与する。

​パスパラメータ

​クエリパラメータ

​ヘッダー

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラーレスポンス

​関連項目

Agent スキル

パスパラメータ

クエリパラメータ

ヘッダー

リクエスト例

レスポンス例

レスポンスフィールド

エラーレスポンス

関連項目