API Reference
The ShackleAI REST API lets you call any installed tool with a simple HTTP request. No MCP protocol knowledge needed.
Authentication
All requests require a Bearer token. Get your API key from Dashboard → Settings.
Authorization: Bearer sk_shackle_YOUR_KEY
Base URL
https://shackleai.com
Endpoints
Response Format
All tool call responses follow this structure:
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the tool executed successfully |
| tool | string | Tool name that was called |
| data | object | Tool output (structure varies per tool) |
| latency_ms | integer | Execution time in milliseconds |
| error | string? | Error message (only present when success is false) |
Status Codes
| Code | Description |
|---|---|
| 200 | Tool executed successfully |
| 401 | Missing or invalid API key |
| 403 | Governance policy denied the call |
| 404 | Tool not found or not installed |
| 422 | Invalid parameters (validation failed) |