メインコンテンツへスキップ
GET /api/v1/cloud/skills/{skill_id} ID を指定して単一の Skill の詳細を取得します。

​
パスパラメータ

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

​
クエリパラメータ

パラメータ型必須説明
include_contentbooleanいいえtrue に設定すると base64 エンコードされた Skill 内容を content に含む

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT

​
リクエスト例

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

​
レスポンス例

HTTP 200 OK 
{
  "id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
  "type": "skill",
  "display_title": "test-skill-api-doc",
  "description": "A test skill for API documentation",
  "source": "custom",
  "latest_version": "1",
  "metadata": {
    "team": "docs"
  },
  "created_at": "2026-05-18T15:35:24.248164Z",
  "updated_at": "2026-05-18T15:35:24.248164Z"
}

​
レスポンスフィールド

フィールド型説明
idstringskill_ プレフィックス付きの Skill 一意識別子
typestring固定値 "skill"
display_titlestring保存された Skill 名から導出される表示タイトル
descriptionstringSkill の説明
sourcestringSkill のソース：custom または qoder
latest_versionstring文字列形式の最新バージョン番号
metadataobjectSkill に保存されるカスタムメタデータオブジェクト。デフォルトは {}
contentstringbase64 エンコードされた Skill 内容。include_content=true 指定時かつ内容が利用可能な場合のみ存在
content_encodingstringcontent とともに存在。値は "base64"
created_atstring作成時刻（ISO 8601）
updated_atstring最終更新時刻（ISO 8601）

​
エラーレスポンス

HTTPtype説明
401TOKEN_INVALID認証トークンが欠落または無効
404not_found_errorSkill が存在しないまたはアクセス不可: “Skill ‘{skill_id}’ was not found.”
完全なエラーエンベロープについては エラー を参照してください。

​
関連項目

Agent スキル

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