Developer documentation

Create an integration key in your portal under Connect. Keys are shown once.

REST API

List the agents your organization can use and read its usage. Hikmu never generates answers on this API: your own AI app does the reasoning.

curl https://hikmu.com/api/v1/agents \
  -H "Authorization: Bearer <YOUR_INTEGRATION_KEY>"

OpenAPI 3.1 (openapi.json)

Error codes

401 — missing, revoked or invalid key
402 — no active subscription
403 — the key cannot use this agent or channel
409 — same Idempotency-Key with a different body
422 — invalid request body
429 — request allowance used up or rate limited
503 — service temporarily paused; retry later

MCP

Point any Streamable HTTP MCP client at this URL. Authenticate with OAuth (where the client supports it) or an integration key in the Authorization header.

https://hikmu.com/mcp

tools: find_experts, consult_expert, get_playbook, lookup_knowledge, run_expert_tool, send_feedback, get_my_usage, connection_health

Webhook signatures

Each delivery is signed with your endpoint secret. Verify the signature and timestamp before trusting the body.

// header: ukh-signature: t=<unix seconds>,v1=<hex>
const expected = hmacSHA256(secret, `${t}.${rawBody}`);
// reject if |now - t| > 300 s or expected !== v1 (constant-time compare)

Hosted Add-on (widget)

<script src="https://hikmu.com/embed.js" data-widget="wid_…" async></script>