K
KILN/
API Documentation
MCP DocsDashboard

API Documentation

Build powerful AI-powered applications with the KILN API. Create agents, manage knowledge bases, execute workflows, and integrate with your existing tools.

Base URL

https://kiln.so/api/v1

Version

v1

Format

JSON

All API requests require a Bearer token. Get your API key from Dashboard → Settings → API Keys.

http
Authorization: Bearer kiln_sk_your_api_key_here

API keys have scoped permissions. You can create keys with read-only access, agent management, or full access including workflow execution.

Permission Scopes

agents:readList and view agents
agents:writeCreate, update, delete agents
chatSend chat messages
knowledge:readList knowledge base entries
knowledge:writeUpload and manage KB data
workflows:readView workflows and executions
workflows:executeRun and manage workflows
webhooks:manageConfigure webhook endpoints

Error Codes

400Bad Request — Invalid parameters or malformed JSON
401Unauthorized — Missing or invalid API key
403Forbidden — API key lacks required scope
404Not Found — Resource does not exist
429Rate Limited — Too many requests (100/min per key)
500Server Error — Unexpected error, please retry

Rate Limits

API requests are rate limited per API key:

Free

100 req/min

Pro

500 req/min

Agency

2,000 req/min

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Need help? Contact support · MCP Documentation · Changelog