---
title: "Runs every tracked prompt across currently green engines (omit Gemini/Perplexity while down). Optional engines allowlist. retry_unmeasured retries not_measured cells only and quotes those cells, not the full set. check_prompt is the 1-check quote for a single query. confirm defaults false. Poll get_scan until completed or partial."
method: POST
path: "/run_scan"
tags: ["action"]
---

# Runs every tracked prompt across currently green engines (omit Gemini/Perplexity while down). Optional engines allowlist. retry_unmeasured retries not_measured cells only and quotes those cells, not the full set. check_prompt is the 1-check quote for a single query. confirm defaults false. Poll get_scan until completed or partial.

`POST /run_scan`

## Request

- Base URL: `https://scope.online/v1`
- URL: `https://scope.online/v1/run_scan`
- Auth: HTTP bearer

## Request body

- object
  - `business_id` string, uuid, required: Owned Scope business ID
  - `confirm` boolean: If false, return a quote only. If true, spend and start the scan.
  - `use_defaults` boolean: Allow Scope's 4 generated prompts when the business has no tracked set.
  - `retry_unmeasured` boolean: Retry not_measured cells only and quote those cells, not the full tracked set. Use this after a partial scan. Alias: force.
  - `force` boolean: Deprecated alias for retry_unmeasured. Prefer retry_unmeasured — some agent harnesses block the word force.
  - `engines` string[]: Optional allowlist. Defaults to every engine on your plan (Growth/Pro: Google AIO, AI Mode, Copilot, ChatGPT Search). Grok is included only when the site llms.txt claims Grok/xAI measurement. Omit down/degraded engines (see get_engine_status).
  - `idempotency_key` string: Stable caller-provided idempotency key

## Response `200`

Tool payload. `meta` holds tldr, next[], pagination cursors, and request_id.

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Quota or over-committed.
- `403`: Missing scope or Growth required.
- `404`: Unknown tool or resource.
- `405`: Wrong HTTP method for this tool.
- `429`: Rate limited (10 action calls / 60s per key; reads are higher).
- `503`: Temporary infrastructure limit — retry with retry_after.

---

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