Skip to main content

API Reference

BrainStack Studio exposes safe capability facades. These endpoints are deterministic and intentionally limited to prevent IP exposure.

Deterministic

Bounded outputs, no hallucinated promises

Safe Facades

No internal orchestration exposed

Base URL

https://brainstackstudio.com

Endpoints

POST
/api/capability/explorer

Deterministic explorer mapping (safe preview)

Core
GET
/api/capability/explorer

Capability facade status and allowed inputs

Utility
POST
/api/lead

Enterprise intake form submission

Lead
POST
/api/telemetry

Anonymous usage telemetry

Internal
POST

/api/capability/explorer

Returns a deterministic workflow preview for a given industry, role, and pain point.

Request Body

json
1
2
3
4
5
{
  "industry": "construction",
  "role": "ops-manager",
  "painPoint": "money"
}

Response

json
1
2
3
4
5
6
7
8
9
10
{
  "status": "ok",
  "confidenceThreshold": 0.65,
  "result": {
    "identifiedPain": "Margin erosion from estimate drift",
    "workflow": ["Capture change orders", "Escalate approvals", "Publish variance report"],
    "confidence": 0.82,
    "confidenceLabel": "High"
  }
}
GET

/api/capability/explorer

Response

json
1
2
3
4
5
6
{
  "status": "ok",
  "industries": ["operations", "construction", "saas", "finance", "supply-chain"],
  "roles": ["owner", "ops-manager", "engineer", "analyst"],
  "painPoints": ["money", "labor", "process", "compliance", "scale", "visibility"]
}

Error Handling

Error Response Format

json
1
2
3
{
  "error": "Missing required fields."
}