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

business_idstring uuid required

Owned Scope business ID

confirmboolean

If false, return a quote only. If true, spend and start the scan.

use_defaultsboolean

Allow Scope's 4 generated prompts when the business has no tracked set.

retry_unmeasuredboolean

Retry not_measured cells only and quote those cells, not the full tracked set. Use this after a partial scan. Alias: force.

forceboolean

Deprecated alias for retry_unmeasured. Prefer retry_unmeasured — some agent harnesses block the word force.

enginesstring[]

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_keystring

Stable caller-provided idempotency key

Response

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

Changes

No recorded changes to this operation across all 1 revision of this API.