Unclassified

Surface / API Mapping

Surface / API Mapping

  • /api/v1/workspace/* backs User Workbench projections.
  • /api/v1/cognitive/* backs the Twin Workbench (Cloudflare-native runtime, iw-agent-runtime).
  • governed approvals, destructive actions, and controlled mutation belong to governance (embedded in Operational Workbench).
  • Twin endpoints are not, by themselves, the customer-facing product-shell contract.

IntegrateWise API Reference

Gateway (port 8786)

All API routes go through the gateway at /api/v1/*.

Authentication

  • Header: Authorization: Bearer <spineDb_jwt>
  • Header: x-tenant-id: <tenant_uuid>
  • Header: x-user-id: <user_uuid>

Core Endpoints

Entity 360

MethodPathDescription
GET/api/v1/entity360/:idGet entity 360 view
POST/api/v1/entity360Get with layer selection
POST/api/v1/entity360/batchBatch multiple entities

Twin

MethodPathDescription
GET/api/v1/cognitive/twin/360/:idEntity 360 + trigger insights
POST/api/v1/cognitive/twin/evaluateBatch trigger evaluation
GET/api/v1/cognitive/twin/triggersList registered triggers
POST/api/v1/cognitive/twin/askNatural language query
POST/api/v1/cognitive/twin/predictPrediction (renewal/risk)

Identity Resolution

MethodPathDescription
GET/api/v1/identity/candidatesList merge candidates
POST/api/v1/identity/candidates/:id/mergeMerge records
POST/api/v1/identity/candidates/:id/keep-separateNot duplicates
POST/api/v1/identity/candidates/:id/deferDefer decision
GET/api/v1/identity/statsResolution statistics

Workspace

MethodPathDescription
GET/api/v1/workspace/entitiesList entities by type
GET/api/v1/workspace/connectorsList connectors

Connectors

MethodPathDescription
GET/api/v1/connectors/:provider/authorizeStart OAuth
GET/api/v1/connectors/:provider/callbackOAuth callback
GET/api/v1/connectors/statsConnector statistics

Intelligence

MethodPathDescription
GET/api/v1/intelligence/signalsActive signals
POST/api/v1/cognitive/think/analyzeManual analysis
GET/api/v1/cognitive/govern/policiesGovernance policies

Knowledge

MethodPathDescription
GET/api/v1/knowledge/memoriesAI memories
GET/api/v1/knowledge/topicsKnowledge topics
GET/api/v1/knowledge/documentsDocuments
POST/api/v1/knowledge/ingestIngest content

Pipeline

MethodPathDescription
GET/api/v1/pipeline/statusPipeline status
GET/api/v1/cognitive/spine/entitiesSpine entities
GET/api/v1/cognitive/spine/dashboardDashboard stats

Service Ports (Local Dev)

ServicePortInspector
Gateway87869246
Web App3000—
Spine-v287959255
Pipeline87949254
Normalizer87939253
Knowledge87899249
Think87989258
Act87809240
Govern87879247
Connector87859245
Workflow88009271
Tenants87979257
Billing87839243
MCP Connector87929252