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:

FieldTypeDescription
successbooleanWhether the tool executed successfully
toolstringTool name that was called
dataobjectTool output (structure varies per tool)
latency_msintegerExecution time in milliseconds
errorstring?Error message (only present when success is false)

Status Codes

CodeDescription
200Tool executed successfully
401Missing or invalid API key
403Governance policy denied the call
404Tool not found or not installed
422Invalid parameters (validation failed)