---
title: "Run query blueprint"
method: POST
path: "/v1/projects/{project_id}/query-blueprints/{blueprint_id}/run"
tags: ["Query Blueprints"]
---

# Run query blueprint

`POST /v1/projects/{project_id}/query-blueprints/{blueprint_id}/run`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/projects/{project_id}/query-blueprints/{blueprint_id}/run`
- Auth: HTTP bearer

Run a deterministic query template. For funnels, set params from the saved signal map's milestones in the source-backed journey order; never rely on default signup steps unless those events are approved and observed for this project.

## Path parameters

- `project_id` string, required
- `blueprint_id` string, required

## Request body

- object
  - `params` object

## Response `200`

OK

- object
  - `blueprint_id` string
  - `title` string
  - `backend` 'analytics' | 'operational'
  - `rows` object[]
  - `columns` string[]
  - `row_count` integer
  - `freshness` object
    - `source` string
    - `consistency` string
    - `cache_bust` boolean
    - `queried_at` string
    - `query_duration_ms` integer
    - `retry_after_ms` integer
    - `status` string
    - `next_action` string
  - `render_hint` object
  - `next_action` string

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)