Documentation
Integration guides, API references, and best practices for Kincaid IQ platform.

Integration Guides

API Reference

POST /api/war-room/ingest
Authentication Required
Ingest single event or batch into War Room. Requires x-kiq-ingest-token header.
curl -X POST https://yourdomain.com/api/war-room/ingest \ -H "Content-Type: application/json" \ -H "x-kiq-ingest-token: your-token" \ -d '{"id":"EVT-001","lane":"value","title":"Test event"}'
GET /api/war-room/stream
Server-Sent Events
Real-time SSE stream for War Room updates (event_upsert, event_delete, ledger_update).
const eventSource = new EventSource('/api/war-room/stream'); eventSource.onmessage = (e) => { const { type, event } = JSON.parse(e.data); // Update UI };
POST /api/packet/submit
Operator Role Required
Submit packet for approval. Enforces policy checks (owner assigned, receipts attached).
curl -X POST /api/packet/submit \ -H "Authorization: Bearer <token>" \ -d '{"eventId":"evt-123"}'
POST /api/macros/submit-drafts
Operator Role Required
Bulk submit up to 25 DRAFT packets in a specific lane. Returns success/failure breakdown.
curl -X POST /api/macros/submit-drafts \ -H "Authorization: Bearer <token>" \ -d '{"lane":"value","max":25}'

Best Practices

Evidence Receipt Quality
  • Always include confidence scores (0.0 - 1.0) from ML models
  • Set freshness thresholds based on data criticality (PT5M for real-time, PT1H for batch)
  • Use SHA-256 hashes for all query results (tamper detection)
  • Include direct links to source queries in Snowflake/Databricks
Change Data Capture (CDC)
  • Hash payloads before delivery to detect meaningful changes
  • Store DELIVERY_HASH in source table to prevent duplicate sends
  • Use LAST_DELIVERED_AT to track delivery timing
  • Log all delivery attempts (success and failure) for audit trail
Security & Compliance
  • Rotate ingest tokens every 90 days (use Snowflake secrets)
  • Grant minimal permissions (USAGE on integration, EXECUTE on procedure)
  • Enable query logging in Snowflake for audit trail
  • Use mTLS for production deployments (certificate-based auth)
Performance Optimization
  • Batch events up to 50 per request (6x faster than serial)
  • Index UPDATED_AT column in WARROOM_EVENTS table
  • Use Snowflake tasks with 5-minute schedule (balance freshness vs cost)
  • Monitor delivery log for failed attempts (retry logic)

Support

Need help with integration or have questions about the platform?

Make value provable.
Kincaid IQ turns complex cost and operational opacity into an auditable ledger with evidence receipts, controls, and action workflows.