Skip to main content

Pro API

Base URL: https://timepoint-pro-cloud-private-production.up.railway.app Requires PRO_API_KEY or X-Service-Key header authentication.

Health Check

GET /health
No auth required.
{
  "status": "healthy",
  "service": "timepoint-pro-cloud",
  "version": "0.1.0",
  "timestamp": "2026-03-07T04:41:45Z"
}

Run Simulation

Pro Cloud wraps the open-source Pro engine with Postgres persistence, Celery job queue, JWT auth, budget enforcement, and usage tracking.

Request

curl -X POST https://timepoint-pro-cloud-private-production.up.railway.app/api/v1/simulate \
  -H "Content-Type: application/json" \
  -H "X-Service-Key: YOUR_KEY" \
  -d '{
    "template": "board-meeting",
    "mode": "FORWARD",
    "fidelity": 3,
    "mechanisms": ["M1", "M3", "M7", "M10", "M13"]
  }'

Parameters

FieldTypeRequiredDescription
templatestringNoOne of 21 verified templates
promptstringNoFree-form scenario description
modestringNoFORWARD, PORTAL, BRANCHING, CYCLICAL, DIRECTORIAL
fidelityintNoSimulation depth (1-5, higher = more detailed + costly)
mechanismsstring[]NoSubset of M1-M19 to enable

Temporal Modes

ModeUse Case
FORWARDStandard timeline progression
PORTALWork backward from desired outcome
BRANCHING”What if” counterfactual analysis
CYCLICALSelf-reinforcing feedback loops
DIRECTORIALNarrative arc with dramatic tension

Cost

0.150.15–1.00 per run depending on fidelity and template complexity. Budget enforcement is built into Pro Cloud.

Output

Simulations produce structured output including:
  • Entity states and relationship graphs
  • Multi-turn dialog with voice consistency
  • Causal provenance chains
  • Confidence scores
  • TDF-formatted export