Agents

CRUD operations for AI agents.

GET/agentsList agents (cursor pagination)

POST/agentsRegister agent

GET/agents/{id}Get agent

PATCH/agents/{id}Update agent

DELETE/agents/{id}Delete agent

POST /agents body

json

{
  "name": "Ops Bot",
  "provider": "openai",
  "status": "pending",
  "environment": "development",
  "risk_level": "medium",
  "slug": "ops-bot",
  "description": "Production ops agent",
  "model": "gpt-4",
  "tags": ["ops"],
  "allowed_tools": ["deploy"],
  "allowed_resources": ["production"],
  "api_key": "ka_secret"
}

Query parameters (GET)

limit (default 20, max 100), cursor, status, provider

curl

curl -X POST https://app.korclaw.com/api/v1/agents \
  -H "Authorization: Bearer kc_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ops Bot","provider":"openai"}'