> ## 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.

# Blueprints

> A collection of Protocols deployed as a unit.

A Blueprint is an ordered collection of Protocols. It represents a complete sensing configuration: everything to measure on a given interaction type, in one deployable unit.

## Structure

```json theme={null}
{
  "id": "advisory-quality",
  "protocols": ["empathy", "clarity", "active-listening"],
  "sgmVersion": "0.2",
  "metadata": { "domain": "financial-advice" }
}
```

## Lifecycle

| State       | Description                                |
| ----------- | ------------------------------------------ |
| `draft`     | Editing in IBE. Not callable from the API. |
| `staged`    | Deployed to Stage for Simulation.          |
| `published` | Production. Versioned and immutable.       |

Published Blueprints are pinned to a specific SGM release. A new SGM release requires a new Blueprint version.

## API usage

Pass a Blueprint id in `blueprint` to run all its Protocols in one call.

```bash theme={null}
curl -X POST https://ibf.blankstate.ai/api/v1/sense \
  -H "Authorization: Bearer $BKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "...",
    "blueprint": "advisory-quality"
  }'
```