Sense
Sense map (Blueprint)
Sense an interaction against a complete Blueprint — returns a full coordinate map of the interaction landscape.
Response includes:
- Actants — participants with influence scores and spatial coordinates
- Interactions — directional flows between actants with strength and active protocols
- Timeline — segment-by-segment protocol measurements over time
- Protocols — aggregate scores for each protocol in the blueprint
- Metrics — computed weighted aggregations
- Flow — overall interaction direction, balance, and phase transitions
POST
/
api
/
v1
/
sense
/
map
curl --request POST \
--url https://api.blankstate.ai/api/v1/sense/map \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"blueprint": "bp_advisor_suitability",
"interaction": {
"content": "I recommend this high-yield fund. Your capital is at risk, but the returns have been strong."
}
}
'{
"blueprint": "bp_advisor_suitability",
"map": {
"actants": [
{
"id": "advisor",
"role": "primary",
"coordinates": {
"x": 0.72,
"y": 0.45
},
"influence_score": 0.85,
"driven_metamarkers": [
"Suitability Check",
"Risk Disclosure"
]
},
{
"id": "client",
"role": "secondary",
"coordinates": {
"x": 0.31,
"y": 0.68
},
"influence_score": 0.34,
"driven_metamarkers": [
"Client Understanding"
]
}
],
"interactions": [
{
"from": "advisor",
"to": "client",
"direction": "outbound",
"strength": 0.78,
"protocols_active": [
"risk-disclosure",
"suitability-check"
]
},
{
"from": "client",
"to": "advisor",
"direction": "inbound",
"strength": 0.42,
"protocols_active": [
"client-understanding"
]
}
],
"timeline": [
{
"segment": 0,
"timestamp_offset": 0,
"actant": "advisor",
"protocols": {
"suitability-check": 0.82,
"risk-disclosure": 0
}
},
{
"segment": 1,
"timestamp_offset": 12.5,
"actant": "client",
"protocols": {
"client-understanding": 0.65
}
},
{
"segment": 2,
"timestamp_offset": 28.3,
"actant": "advisor",
"protocols": {
"risk-disclosure": 0.88,
"suitability-check": 0.76
}
}
],
"protocols": {
"risk-disclosure": {
"score": 0.82,
"metamarkers": 2
},
"suitability-check": {
"score": 0.78,
"metamarkers": 2
},
"client-understanding": {
"score": 0.65,
"metamarkers": 1
}
},
"metrics": {
"overall-compliance": {
"score": 0.79,
"components": 3
},
"interaction-quality": {
"score": 0.81,
"components": 2
}
},
"flow": {
"dominant_direction": "advisor → client",
"balance": 0.65,
"phase_shifts": 2
},
"overall": 0.8
},
"evidence": {
"risk-disclosure": [
{
"metamarker": "Risk Warning",
"actant": "advisor",
"source": "Your capital is at risk"
}
],
"suitability-check": [
{
"metamarker": "Needs Assessment",
"actant": "advisor",
"source": "Based on your goals"
}
],
"client-understanding": [
{
"metamarker": "Clarification Request",
"actant": "client",
"source": "What are the risks?"
}
]
},
"fidelity": {
"index": 0.74,
"sufficient": true
},
"ics": {
"consumed": 5,
"cost_usd": 0.015
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired API token. Obtain a new token from atlas.blankstate.ai"
}
}{
"error": {
"code": "quota_exhausted",
"message": "Your free ICS quota for this period has been consumed. Add a payment method at atlas.blankstate.ai to continue.",
"details": {
"quota": 50,
"used": 50,
"reset": "2026-03-01T00:00:00Z"
}
}
}{
"error": {
"code": "target_not_found",
"message": "Protocol 'non-existent-protocol' not found or not available to your organization"
}
}Authorizations
API token from Atlas Dashboard
Response
Map complete — full coordinate map of the interaction
⌘I
curl --request POST \
--url https://api.blankstate.ai/api/v1/sense/map \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"blueprint": "bp_advisor_suitability",
"interaction": {
"content": "I recommend this high-yield fund. Your capital is at risk, but the returns have been strong."
}
}
'{
"blueprint": "bp_advisor_suitability",
"map": {
"actants": [
{
"id": "advisor",
"role": "primary",
"coordinates": {
"x": 0.72,
"y": 0.45
},
"influence_score": 0.85,
"driven_metamarkers": [
"Suitability Check",
"Risk Disclosure"
]
},
{
"id": "client",
"role": "secondary",
"coordinates": {
"x": 0.31,
"y": 0.68
},
"influence_score": 0.34,
"driven_metamarkers": [
"Client Understanding"
]
}
],
"interactions": [
{
"from": "advisor",
"to": "client",
"direction": "outbound",
"strength": 0.78,
"protocols_active": [
"risk-disclosure",
"suitability-check"
]
},
{
"from": "client",
"to": "advisor",
"direction": "inbound",
"strength": 0.42,
"protocols_active": [
"client-understanding"
]
}
],
"timeline": [
{
"segment": 0,
"timestamp_offset": 0,
"actant": "advisor",
"protocols": {
"suitability-check": 0.82,
"risk-disclosure": 0
}
},
{
"segment": 1,
"timestamp_offset": 12.5,
"actant": "client",
"protocols": {
"client-understanding": 0.65
}
},
{
"segment": 2,
"timestamp_offset": 28.3,
"actant": "advisor",
"protocols": {
"risk-disclosure": 0.88,
"suitability-check": 0.76
}
}
],
"protocols": {
"risk-disclosure": {
"score": 0.82,
"metamarkers": 2
},
"suitability-check": {
"score": 0.78,
"metamarkers": 2
},
"client-understanding": {
"score": 0.65,
"metamarkers": 1
}
},
"metrics": {
"overall-compliance": {
"score": 0.79,
"components": 3
},
"interaction-quality": {
"score": 0.81,
"components": 2
}
},
"flow": {
"dominant_direction": "advisor → client",
"balance": 0.65,
"phase_shifts": 2
},
"overall": 0.8
},
"evidence": {
"risk-disclosure": [
{
"metamarker": "Risk Warning",
"actant": "advisor",
"source": "Your capital is at risk"
}
],
"suitability-check": [
{
"metamarker": "Needs Assessment",
"actant": "advisor",
"source": "Based on your goals"
}
],
"client-understanding": [
{
"metamarker": "Clarification Request",
"actant": "client",
"source": "What are the risks?"
}
]
},
"fidelity": {
"index": 0.74,
"sufficient": true
},
"ics": {
"consumed": 5,
"cost_usd": 0.015
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired API token. Obtain a new token from atlas.blankstate.ai"
}
}{
"error": {
"code": "quota_exhausted",
"message": "Your free ICS quota for this period has been consumed. Add a payment method at atlas.blankstate.ai to continue.",
"details": {
"quota": 50,
"used": 50,
"reset": "2026-03-01T00:00:00Z"
}
}
}{
"error": {
"code": "target_not_found",
"message": "Protocol 'non-existent-protocol' not found or not available to your organization"
}
}