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

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.

GET /v1/agents 現在のアカウント配下のすべての Agent を一覧表示します。ページネーションとソートをサポートします。

​
ヘッダー

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

​
クエリパラメータ

パラメータ型必須デフォルト値説明
limitintegerいいえ201 ページあたりの返却件数、範囲 1-100
orderstringいいえdescソート方向、asc または desc
after_idstringいいえ-カーソルページング、この ID より後のレコードを返す
before_idstringいいえ-カーソルページング、この ID より前のレコードを返す

​
リクエスト例

curl -X GET "https://openapi.qoder.sh/api/v1/cloud/agents?limit=2&order=desc" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "data": [
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent",
      "description": "",
      "model": "ultimate",
      "system": "あなたはドキュメントテストアシスタントです",
      "instructions": "あなたはドキュメントテストアシスタントです",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 1,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:26:39.61669Z"
    },
    {
      "type": "agent",
      "id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
      "name": "test-agent-e2e",
      "description": "E2E テスト用 Agent",
      "model": "ultimate",
      "system": "あなたはテストアシスタントです",
      "instructions": "あなたはテストアシスタントです",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 2,
      "created_at": "2026-05-18T03:04:33.952256Z",
      "updated_at": "2026-05-18T03:05:28.023697Z"
    }
  ],
  "first_id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "last_id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
  "has_more": true
}

​
レスポンスフィールド

フィールド型説明
dataarrayAgent オブジェクトの配列
first_idstring現在のページの最初のレコードの ID
last_idstring現在のページの最後のレコードの ID
has_morebooleanさらにデータがあるかどうか

​
ページネーションの使い方

次のページを取得（前進）: 
curl "https://openapi.qoder.sh/api/v1/cloud/agents?limit=20&after_id=agent_019eYYYY..."
前のページを取得（後退）: 
curl "https://openapi.qoder.sh/api/v1/cloud/agents?limit=20&before_id=agent_019eXXXX..."
詳細は ページネーション を参照してください。

​
エラーコード

HTTPtypeトリガー条件
401authentication_errorPAT が無効または期限切れ
403permission_errorこの操作を実行する権限がない
400invalid_request_errorlimit が範囲外、またはパラメータ形式エラー

​
注意事項

  • デフォルトでは作成時刻の降順（最新が先頭）でソートされます。
  • アーカイブ済みの Agent はデフォルトの一覧には表示されません。
  • カーソルページネーション（cursor-based pagination）を使用し、offset 方式はサポートしません。