Purpose
The Admin API provides programmatic access to manage tools and providers in HandsAI. These endpoints allow you to:- Manage Tools: Create, update, retrieve, and delete API tool definitions
- Manage Providers: Configure external API providers with authentication settings
- Validate Health: Check tool endpoint availability
- View Analytics: Track execution metrics and logs for monitoring and debugging
For bulk operations, use the Import/Export API which handles batch processing of tools and providers.
Base Paths
- Tools:
/admin/tools/api - Providers:
/admin/providers - Analytics:
/admin/analytics
Authentication
All Admin API endpoints require authentication. Include your credentials in the request headers:Authentication implementation details depend on your HandsAI deployment configuration.
CRUD Operations Overview
Tools Management
| Operation | Method | Endpoint |
|---|---|---|
| List all tools | GET | /admin/tools/api |
| Get tool by ID | GET | /admin/tools/api/{id} |
| Create tool | POST | /admin/tools/api |
| Update tool | PUT | /admin/tools/api/{id} |
| Delete tool | DELETE | /admin/tools/api/{id} |
| Validate health | POST | /admin/tools/api/{id}/validate |
| Create batch | POST | /admin/tools/api/batch |
Providers Management
| Operation | Method | Endpoint |
|---|---|---|
| List all providers | GET | /admin/providers |
| Get provider by ID | GET | /admin/providers/{id} |
| Create provider | POST | /admin/providers |
| Update provider | PUT | /admin/providers/{id} |
| Delete provider | DELETE | /admin/providers/{id} |
Analytics & Monitoring
| Operation | Method | Endpoint |
|---|---|---|
| Get summary metrics | GET | /admin/analytics/summary |
| Get execution logs | GET | /admin/analytics/logs |
Next Steps
Tool Management
Manage API tool definitions and configurations
Provider Management
Configure external API providers and authentication
Analytics & Logs
View execution metrics and troubleshoot issues