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": [
    {
      "name": "<string>",
      "organization_id": "<string>",
      "webhook_url": "<string>",
      "created_by_details": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "id": "<string>",
      "unique_name": "<string>",
      "origin_template": "<string>",
      "environment_id": "<string>",
      "deployment_type": "serverless",
      "prompts": [],
      "is_latest": false,
      "has_pending_changes": false,
      "deep_planning": false,
      "enforce_deep_planning": false,
      "connectivity_details": {},
      "framework": "agno",
      "description": "",
      "tools": [],
      "icon": "🚀",
      "avatar": "male-avatar",
      "source_nodes": [],
      "attached_tools": [],
      "access_scope": "personal",
      "instructions": {
        "role": [],
        "goal": [],
        "general": ""
      },
      "oas": {},
      "graph": [],
      "status": "ACTIVE",
      "knowledge_bases": [],
      "version": 1,
      "created_by": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "using_nemo": false,
      "deletable": true,
      "model_provider": "anthropic",
      "model_name": "claude-sonnet-4-6",
      "llm_reasoning_effort": "medium",
      "llm_api_base": "<string>",
      "output_format": "markdown",
      "voice_id": "<string>",
      "output_schema": {},
      "llm_credentials_key": "<string>",
      "llm_credentials_key_type": "xpander",
      "llm_credentials": {
        "name": "<string>",
        "value": "<string>",
        "description": "<string>"
      },
      "llm_extra_headers": {},
      "expected_output": "",
      "agno_settings": {
        "session_storage": true,
        "learning": false,
        "agent_memories": false,
        "agentic_culture": false,
        "user_memories": false,
        "agentic_memory": false,
        "session_summaries": false,
        "num_history_runs": 10,
        "max_tool_calls_from_history": 0,
        "tool_call_limit": 0,
        "coordinate_mode": true,
        "pii_detection_enabled": false,
        "pii_detection_mask": true,
        "prompt_injection_detection_enabled": false,
        "openai_moderation_enabled": false,
        "reasoning_tools_enabled": false,
        "tool_calls_compression": {
          "enabled": false,
          "instructions": "",
          "threshold": 3
        },
        "max_plan_retries": 15,
        "plan_retry_strategy": "tiered"
      },
      "on_prem_event_streaming": true,
      "is_supervised": false,
      "orchestration_nodes": [],
      "notification_settings": {},
      "task_level_strategies": {
        "retry_strategy": {
          "enabled": false,
          "max_retries": 3
        },
        "iterative_strategy": {
          "enabled": false,
          "max_iterations": 3,
          "end_condition": {
            "term": "<string>",
            "group_id": "<string>",
            "path": "<string>",
            "value": null
          }
        },
        "stop_strategy": {
          "enabled": false,
          "stop_on_failure": true,
          "stop_on_condition": {
            "term": "<string>",
            "group_id": "<string>",
            "path": "<string>",
            "value": null
          }
        },
        "max_runs_per_day": 123,
        "agentic_context_enabled": false,
        "duplication_prevention": {
          "selectors": [
            "<string>"
          ],
          "enabled": false,
          "ttl_minutes": 10
        }
      },
      "use_oidc_pre_auth": false,
      "pre_auth_audiences": [],
      "use_oidc_pre_auth_token_for_llm": false,
      "oidc_pre_auth_token_llm_audience": "<string>",
      "oidc_pre_auth_token_mcp_audience": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "per_page": 123,
  "total_pages": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt

Use this file to discover all available pages before exploring further.

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",
      "created_at": "2026-02-05T18:35:04.724091Z",
      "created_by": "<user-id>",
      "created_by_details": {
        "id": "<user-id>",
        "name": "Jane Doe",
        "email": "jane@acme.com"
      },
      "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[]
required
​
total
integer
required
​
page
integer
required
​
per_page
integer
required
​
total_pages
integer
required