エージェント一覧取得
指定したワークスペースに属するエージェントの一覧を返します。
リクエスト
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|
Authorization | はい | Bearer snorbe_... 形式の API キー |
ワークスペースは API キーに紐づくものが自動的に使用されます。パラメータは不要です。
レスポンス
[
{
"id": "clxxx123456",
"name": "Research Agent",
"isDefault": true,
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-03-20T14:22:00.000Z"
},
{
"id": "clxxx789012",
"name": "Patent Analyst",
"isDefault": false,
"createdAt": "2026-02-10T08:00:00.000Z",
"updatedAt": "2026-02-10T08:00:00.000Z"
}
]
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|
id | string | エージェント ID |
name | string | エージェント名 |
isDefault | boolean | デフォルトエージェントかどうか |
createdAt | string | 作成日時（ISO 8601） |
updatedAt | string | 更新日時（ISO 8601） |
使用例
curl "https://app.snorbe.deskrex.ai/api/v1/agent/list" \
-H "Authorization: Bearer snorbe_your_api_key_here"
エラーレスポンス
| HTTP ステータス | コード | 説明 |
|---|
| 401 | UNAUTHORIZED | API キーが無効、期限切れ、または未指定 |
| 429 | TOO_MANY_REQUESTS | レート制限超過 |
