API quickstart

The IBF API is available under an Atlas engagement. See Atlas quickstart to open access.

Get a key

Once your Atlas tenant is provisioned, your API key is in Atlas > API Dashboard.

Send your first sense call

curl -X POST https://ibf.blankstate.ai/api/v1/sense \
  -H "Authorization: Bearer $BKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "I understand this has been a difficult quarter. Let me walk you through exactly what happened.",
    "modality": "text",
    "protocols": ["empathy"],
    "actantId": "user_001"
  }'

Read the response

{
  "protocol": "empathy",
  "score": 0.74,
  "fidelity": 0.88,
  "metamarkers": [
    {
      "nuance": "acknowledges-emotional-state",
      "dimension": "B",
      "score": 0.81,
      "fidelity": 0.91,
      "segment": {
        "start": 0,
        "end": 53,
        "text": "I understand this has been a difficult quarter."
      }
    }
  ]
}

Run a Blueprint

Pass a Blueprint id to run a full sensing configuration in one call.

curl -X POST https://ibf.blankstate.ai/api/v1/sense \
  -H "Authorization: Bearer $BKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "...",
    "modality": "text",
    "blueprint": "advisory-quality",
    "actantId": "user_001"
  }'

TypeScript SDK: typed client
CLI: shell access
MCP: agent-native sensing
Protocols reference: how Protocols work
ICS billing: how billing accrues

⌘I

Get started

Foundations

S&D

Atlas

Resources

Run a Blueprint

Next

​Run a Blueprint

​Next

Run a Blueprint

Next