> ## Documentation Index > Fetch the complete documentation index at: https://doc.blankstate.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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 ## OpenAPI ````yaml /openapi/client_v1_0.json post /api/v1/sense/map openapi: 3.1.0 info: title: Blankstate IBF API version: 0.2.0 description: >- ## Universal Interaction Sensing Measure any interaction against configurable **Protocols**, **Metrics**, and **Blueprints**. ### Core Concepts | Concept | Description | |---------|-------------| | **Protocol** | A sensor that detects specific interaction patterns (metamarkers) | | **Metric** | Weighted aggregation of protocol scores | | **Blueprint** | A complete sensing configuration, multiple protocols + metrics | | **ICS** | Interaction Computed Signal, outcome-based billing (1 ICS = 1 triggered metamarker) | | **Fidelity** | Information sufficiency, does the input contain enough signal for reliable measurement? | ### Sensing Profiles Every sensing request accepts an optional `profile` parameter. The default is `raw`. | Profile | Description | |---------|-------------| | `raw` | *(default)* Raw sensor output. The sensor measures exactly what the protocol defines. Nothing added, nothing filtered. | | `detailed` | Same measurement + deep evidence chains with segment-level attribution and full reconstruction provenance. | | `discovery` | Same measurement + weak signal indicators. Near-threshold activations are reported separately so you can explore what the sensor _almost_ detected. | All profiles are **deterministic**: same profile + same input + same protocol = same output, always. ### SGM Version The API currently runs against SGM **0.2** in production. The API URL stays `/api/v1/` across model iterations. Existing Protocols continue to run against the same URL as the underlying model advances; version pinning lives on the Protocol itself. ### Base URL ``` https://ibf.blankstate.ai ``` ### Authentication ``` Authorization: Bearer YOUR_API_TOKEN ``` Obtain tokens from the [Atlas Dashboard](https://atlas.blankstate.ai/api-dashboard/tokens). ### Response Headers Every sensing response includes: | Header | Description | |--------|-------------| | `X-ICS-Consumed` | ICS consumed by this request | | `X-ICS-Remaining` | Remaining ICS quota for current period | | `X-RateLimit-Limit` | Maximum requests per window | | `X-RateLimit-Remaining` | Remaining requests in current window | | `X-RateLimit-Reset` | Unix timestamp when the rate limit resets | contact: name: Blankstate AI url: https://blankstate.ai email: contact@blankstate.ai servers: - url: https://ibf.blankstate.ai description: Production security: - BearerAuth: [] tags: - name: Health description: Service status and token verification - name: Sense description: >- Core measurement, sense interactions against protocols, metrics, or blueprints - name: Fidelity description: Pre-check information sufficiency before sensing (zero ICS cost) - name: Protocols description: Protocol sensors, browse and inspect detection configurations - name: Metrics description: Weighted aggregations of protocol scores - name: Blueprints description: Complete sensing configurations, protocols + metrics composed together - name: Usage description: ICS consumption, quotas, and cost estimation - name: Jobs description: Asynchronous job tracking for large file and batch processing - name: Capabilities description: Machine-readable API capability descriptions for tooling integration paths: /api/v1/sense/map: post: tags: - Sense summary: Sense map (Blueprint) description: >- 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 operationId: senseMap requestBody: required: true content: application/json: examples: basic: summary: Sense against blueprint value: blueprint: bp_advisor_suitability interaction: content: >- I recommend this high-yield fund. Your capital is at risk, but the returns have been strong. transcript: summary: Transcript with full map value: blueprint: bp_advisor_suitability interaction: segments: - role: advisor content: Based on your goals, I'd suggest a balanced portfolio. - role: client content: That sounds reasonable. What are the risks? - role: advisor content: >- Market volatility could affect returns, but historically... responses: '200': description: Map complete, full coordinate map of the interaction content: application/json: example: 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 '401': $ref: '#/components/responses/Unauthorized' description: Invalid or missing authentication token '402': $ref: '#/components/responses/QuotaExhausted' description: ICS quota exhausted for current period '404': $ref: '#/components/responses/TargetNotFound' description: Protocol, metric, or blueprint not found components: responses: Unauthorized: description: Invalid or missing authentication token content: application/json: example: error: code: unauthorized message: >- Invalid or expired API token. Obtain a new token from atlas.blankstate.ai QuotaExhausted: description: ICS quota exhausted, free tier consumed and no payment method on file content: application/json: example: 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' TargetNotFound: description: The specified protocol, metric, or blueprint was not found content: application/json: example: error: code: target_not_found message: >- Protocol 'non-existent-protocol' not found or not available to your organization securitySchemes: BearerAuth: type: http scheme: bearer description: API token from Atlas Dashboard ````