---
title: "Quote-first enroll for one tracked prompt. confirm defaults false (burn quote only); confirm true writes the prompt and committed burn from check_interval_days (default every 5 days, not calendar month). Pass cadence or check_interval_days to change the account interval (monthly→30, weekly→7). Returns compiled_text, intent, collision_risk, checks_per_cycle, checks_per_month, interval_label, and cadence (every_N_days). Refuse collision_risk > 0.7 unless confirm_ambiguous is true. Requires prompts:write."
method: POST
path: "/track_prompt"
tags: ["action"]
---

# Quote-first enroll for one tracked prompt. confirm defaults false (burn quote only); confirm true writes the prompt and committed burn from check_interval_days (default every 5 days, not calendar month). Pass cadence or check_interval_days to change the account interval (monthly→30, weekly→7). Returns compiled_text, intent, collision_risk, checks_per_cycle, checks_per_month, interval_label, and cadence (every_N_days). Refuse collision_risk > 0.7 unless confirm_ambiguous is true. Requires prompts:write.

`POST /track_prompt`

## Request

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

## Request body

- object
  - `business_id` string, uuid, required: Owned Scope business ID
  - `prompt` string, required: Prompt to track
  - `confirm` boolean: If false, return a quote only. If true, enroll the prompt.
  - `cadence` 'monthly' | 'weekly': When present, sets the account interval: monthly=30, weekly=7. Not applied from the schema default.
  - `check_interval_days` 1 | 3 | 5 | 7 | 14 | 30: Account-wide check interval. Overrides cadence when both are sent.
  - `confirm_ambiguous` boolean: Required when collision_risk is above 0.7

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