Skip to main content
GET
/
v1
/
agents
/
full
List Agents (Full)
curl --request GET \
  --url https://api.xpander.ai/v1/agents/full \
  --header 'x-api-key: <api-key>'
{
  "items": [
    {
      "id": "93a1cd50-2af0-452a-99a0-6e1f1b14fb29",
      "name": "Product Specialist",
      "description": "Answers product questions using web search and documentation",
      "icon": "🚀",
      "status": "ACTIVE",
      "deployment_type": "serverless",
      "created_at": "2026-02-05T18:54:51.388334Z",
      "model_provider": "anthropic",
      "model_name": "claude-sonnet-4-5-20250929",
      "framework": "agno",
      "organization_id": "91fbe9bc-35b3-41e8-b59d-922fb5a0f031",
      "tools": [
        {
          "id": "XpanderEmailServiceSendEmailWithHtmlOrTextContent",
          "name": "Send Email",
          "method": "post",
          "path": "/operation/XpanderEmailServiceSendEmailWithHtmlOrTextContent/messaging/send_email"
        }
      ],
      "graph": [
        {
          "id": "124fe641-c1dc-4a2a-89d0-36f9bda2df75",
          "item_id": "XpanderEmailServiceSendEmailWithHtmlOrTextContent",
          "name": "Send Email",
          "type": "tool",
          "targets": [],
          "is_first": false
        }
      ],
      "knowledge_bases": [],
      "instructions": {
        "role": [
          "AI support agent for xpander.ai"
        ],
        "goal": [
          "Be helpful and accurate"
        ],
        "general": "You are the official xpander.ai support agent."
      },
      "output_format": "text",
      "expected_output": "Short answer, formatted in rich markdown text.",
      "webhook_url": "https://webhook.xpander.ai/?agent_id=93a1cd50-2af0-452a-99a0-6e1f1b14fb29&asynchronous=false",
      "unique_name": "emerald-emu",
      "llm_api_base": null,
      "has_pending_changes": false,
      "llm_settings": [
        {
          "type": "before",
          "provider": "openai",
          "model": "gpt-5.2",
          "temperature": 0
        }
      ],
      "agno_settings": {
        "session_storage": true,
        "agent_memories": false,
        "coordinate_mode": true,
        "num_history_runs": 20,
        "tool_call_limit": 0
      }
    }
  ],
  "total": 12,
  "page": 1,
  "per_page": 20,
  "total_pages": 1
}
Retrieve a paginated list of AI agents with complete information including configuration, tools, knowledge bases, and deployment details. This endpoint provides more detailed information than the minimal list endpoint.

​
Query Parameters

​
page
integer
default:1
Page number (starting from 1)
​
per_page
integer
default:20
Items per page (maximum 50)

​
Response

Returns a paginated list of agents with complete details:
​
items
array
Array of complete agent objects
​
total
integer
Total number of agents across all pages
​
page
integer
Current page number
​
per_page
integer
Number of items per page
​
total_pages
integer
Total number of pages available

​
Example Request

curl -X GET -H "x-api-key: <your-api-key>" \
  "https://api.xpander.ai/v1/agents/full?page=1&per_page=2"

​
Example Response

{
  "items": [
    {
      "id": "<agent-id>",
      "unique_name": "product-specialist",
      "name": "Product Specialist",
      "description": "Processes queries to provide comprehensive product information",
      "icon": "🚀",
      "status": "ACTIVE",
      "organization_id": "<org-id>",
      "deployment_type": "serverless",
      "framework": "agno",
      "type": "manager",
      "delegation_type": "router",
      "created_at": "2026-02-05T18:35:04.724091Z",
      "model_provider": "openai",
      "model_name": "gpt-4.1",
      "instructions": {
        "role": [
          "You are a product specialist assistant"
        ],
        "goal": [
          "Provide accurate product information to customers"
        ],
        "general": "Be helpful and professional"
      },
      "tools": [
        {
          "id": "search-products",
          "name": "Search Products",
          "method": "get",
          "path": "/products/search"
        }
      ],
      "knowledge_bases": [],
      "graph": [],
      "access_scope": "organizational"
    }
  ],
  "total": 41,
  "page": 1,
  "per_page": 2,
  "total_pages": 21
}

​
Notes

  • This endpoint returns complete agent configurations, which may be slower than the minimal list endpoint
  • Use the minimal list endpoint (GET /v1/agents) if you only need basic agent information
  • The response is automatically filtered based on your API key’s permissions
  • Large responses may take longer to retrieve due to nested configurations

​
See Also

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Query Parameters

​
page
integer
default:1

Page number (starting from 1)

Required range: x >= 1
​
per_page
integer
default:20

Items per page (max 50)

Required range: 1 <= x <= 50

Response

Successful Response

​
items
AIAgent · object[]
​
total
integer
​
page
integer
​
per_page
integer
​
total_pages
integer