Blueprint Lifecycle
Create, inspect, clone, and review blueprint runs through the REST lifecycle endpoints.
Use this surface when you want deterministic blueprint management. Chat remains the better entry point for AI-assisted edits and graph changes.
Create
POST
/api/v1/blueprints| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Display title for the new blueprint |
Response
{
"blueprintId": "bp_..."
}Get Blueprint
GET
/api/v1/blueprints/{blueprintId}Returns the enriched blueprint payload, including the steps and derived metadata needed for downstream execution or inspection.
Clone
POST
/api/v1/blueprints/{blueprintId}/clone| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | No | Optional title for the cloned blueprint |
Response
{
"blueprintId": "bp_..."
}Runs
GET
/api/v1/blueprints/{blueprintId}/runsReturns the run history for a blueprint. Each item includes the run status plus any thumbnail URL generated for the output.