API REFERENCE

Build on Galvafy.

Full REST APIs for Cortex and Core. OpenAPI-compliant, versioned, and documented with examples.

Cortex Endpoints

POST/v1/cortex/query

Natural language query across connected data sources. Returns structured answer with citations.

GET/v1/cortex/signals

List active signals with severity, category, and correlation metadata.

GET/v1/cortex/briefings

Retrieve Pulse Briefings with recommended actions and priority scores.

POST/v1/cortex/corpora

Create a new RAG corpus and ingest documents for retrieval-augmented generation.

POST/v1/cortex/infer

Run an AI inference task against a corpus or model. Streaming supported.

// POST /v1/cortex/query
{
  "query": "Which customers haven't reordered in 90+ days?",
  "sources": ["hubspot", "stripe", "shopify"],
  "corpus_id": "corp_abc123"
}

// 200 Response
{
  "answer": "47 customers representing $284K in annual revenue have not reordered in 90+ days.",
  "confidence": 0.94,
  "latency_ms": 812,
  "citations": ["hubspot.contacts", "stripe.invoices"]
}

Core Endpoints

GET/v1/identity

Get the authenticated user's identity, profile, and platform entitlements.

GET/v1/entitlements/{product}

Check entitlement status for a specific product and feature set.

POST/v1/tasks/trigger

Trigger a platform task or workflow event programmatically.

POST/v1/webhooks

GET/v1/audit-logs

Query the audit log for authentication, entitlement, and API events.

// GET /v1/identity
Authorization: Bearer {api_key}

// 200 Response
{
  "userId": "usr_abc123",
  "email": "jane@acme.com",
  "org": "org_xyz789",
  "entitlements": {
    "forge": "professional",
    "cortex": "developer",
    "core": "included"
  },
  "sso_provider": "microsoft"
}