dcAI — API Documentation

dcAI Gateway API

All endpoints require a Bearer JWT token obtained via Google/GitHub OAuth or email login.

LIVE https://api.deepcognitive.io

Authorization: Bearer <your_jwt_token>

# Get your token via login:
POST /api/auth/login
{ "email": "you@co.com", "password": "..." }
→ { "token": "eyJ..." }

Authentication

Login, signup, OAuth, and token management

POST/api/auth/signupPublic

Create account · returns JWT token

POST/api/auth/loginPublic

Email/password login · returns JWT token

GET/api/auth/googlePublic

Initiate Google OAuth flow

GET/api/auth/githubPublic

Initiate GitHub OAuth flow

GET/api/auth/meJWT

Get current tenant profile

Workflows / Flows

Create and list integration workflows

POST/api/flowsJWT

Create a new workflow flow

GET/api/flowsJWT

List all flows for your tenant

# Trigger a workflow via SSE server:
POST https://flows.deepcognitive.io/prompt
{
  "prompt": "Sync Stripe payments to HubSpot",
  "fault": false,
  "steps": ["stripe", "hubspot"],
  "tenant_token": "<jwt>"
}

Connectors / Credential Vault

Store and manage encrypted API credentials per connector

POST/api/connectors/connectJWT

Store connector credentials (AES-256 encrypted)

GET/api/connectorsJWT

List all connected platforms

GET/api/connectors/{name}/credentialsJWT

Retrieve decrypted credentials (engine use only)

DELETE/api/connectors/{name}JWT

Disconnect a platform

Webhooks

Register inbound webhook endpoints that auto-trigger workflows

POST/api/webhooks/registerJWT

Register a webhook source (Stripe, HubSpot, GitHub, Shopify)

GET/api/webhooksJWT

List registered webhook endpoints

POST/api/webhooks/{source}/{tenant_id}Public

Inbound webhook receiver — point your source here

GET/api/webhooks/{source}/eventsJWT

Fetch recent events for a source

DELETE/api/webhooks/{source}JWT

Deactivate a webhook endpoint

# Example webhook URL for Stripe:
https://api.deepcognitive.io/api/webhooks/stripe/{your_tenant_id}

RAG / Failure Memory

Per-tenant transform rules learned from AI self-healing

GET/api/rag/rulesJWT

List all stored transform rules for your tenant

POST/api/rag/saveJWT

Save a new transform rule (auto-called by the AI engine)

Realtime / SSE

Server-Sent Events stream and workflow trigger — served from flows.deepcognitive.io

GEThttps://flows.deepcognitive.io/eventsPublic

SSE stream — connect to receive live workflow events

POSThttps://flows.deepcognitive.io/promptPublic

Trigger a workflow run

# Listen to live events (JavaScript):
const es = new EventSource('https://flows.deepcognitive.io/events');
es.onmessage = e => {
  const event = JSON.parse(e.data);
  // types: prompt, step, heal, success, log, webhook_received
  console.log(event.type, event);
};