メインコンテンツへスキップ

​
スキル一覧取得

API キーに紐づくワークスペースで、インストール済み or 有効化されているカスタムスキルの一覧を返します。エージェントが「どのスキルを呼べるか」を事前に把握したり、UI にスキルバッジを表示したりするのに使います。
API キー認証が必要です。返すのは API キーのワークスペース内に存在するスキルのみで、他ワークスペースや storagePath などの内部識別子は返しません。

​
リクエスト

GET /api/v1/skill/list

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer snorbe_... 形式の API キー
ワークスペースは API キーに紐づくものが自動的に使用されます。パラメータは不要です。

​
レスポンス

[
  {
    "id": "cl123abc",
    "name": "Patent Search",
    "description": "Patent search workflow for semiconductor domain",
    "enabled": true,
    "isOfficial": false
  },
  {
    "id": "cl456def",
    "name": "Snorbe API",
    "description": "Invoke Snorbe REST API from inside an agent",
    "enabled": true,
    "isOfficial": true
  }
]

​
レスポンスフィールド

フィールド型説明
idstringスキル ID
namestringスキル名
descriptionstringスキルの説明
enabledbooleanワークスペース内で有効化されているか
isOfficialbooleanSnorbe 公式スキル（npx skills add deskrexai/snorbe 等でインストール）かどうか
storagePath・所有者 ID など内部実装の識別子はレスポンスに含まれません。

​
使用例

curl "https://app.snorbe.deskrex.ai/api/v1/skill/list" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

​
エラーレスポンス

HTTP ステータスコード説明
401UNAUTHORIZEDAPI キーが無効、期限切れ、または未指定
429TOO_MANY_REQUESTSレート制限超過

​
関連