Skip to main content
GET
/
v1
/
toolkits
List Toolkits
curl --request GET \
  --url https://api.xpander.ai/v1/toolkits \
  --header 'x-api-key: <api-key>'
{
  "items": [
    {
      "id": "8904cc9f-a3f2-4e8e-8123-036dbaecb951",
      "name": "Email Service",
      "description": "Send emails with HTML content",
      "category": "messaging",
      "tool_count": 3
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20,
  "total_pages": 1
}
Retrieve a paginated list of all available toolkits in your organization. Toolkits are collections of related tools that agents can use to perform specific tasks.

​
Query Parameters

​
page
integer
default:1
Page number for pagination (starting from 1)
​
per_page
integer
default:20
Number of items per page (default: 20, maximum: 100)

​
Response

​
items
array
Array of toolkit objects
​
total
integer
Total number of toolkits in your organization
​
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/toolkits?page=1&per_page=20"

​
Example Response

{
  "items": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "name": "Slack Integration",
      "description": "Tools for interacting with Slack channels and users",
      "tools": ["send-message", "get-channels", "list-users"]
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "GitHub Connector",
      "description": "Tools for GitHub repository and issue management",
      "tools": ["create-issue", "list-repos", "get-commit-history"]
    }
  ],
  "total": 2,
  "page": 1,
  "per_page": 20,
  "total_pages": 1
}

​
Notes

  • Returns an empty list if no custom toolkits are configured
  • Built-in tools are available directly on agents without requiring toolkits
  • Custom toolkits can be created and managed through the web dashboard
  • Use the toolkit id to retrieve tool definitions with Get Toolkit Tools

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
Toolkit · object[]
​
total
integer
​
page
integer
​
per_page
integer
​
total_pages
integer