## monitors/propose

`GET /v1/monitors/propose`

Turns a plain-English request into a complete, editable monitor proposal: what it watches, the identifiers it found, the platforms, the matching rules and exclusions, the frequency, the delivery and the estimated cost, with the reason for each choice. Nothing is created.

*Propose a monitor from plain English*

| Parameter | Required | Description |
| --- | --- | --- |
| `text` | yes | What you want to keep an eye on, in a sentence — e.g. `Tell me when people complain about Monzo on Reddit or Hacker News` |
| `template` | no | Start from a template id instead of, or as well as, the sentence — e.g. `complaints` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** free — 0 credits.

```bash
curl "https://www.monocrawl.com/v1/monitors/propose?text=Tell%20me%20when%20people%20complain%20about%20Monzo%20on%20Reddit%20or%20Hacker%20News" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "proposal": {},
  "notes": [],
  "requires_choice": false,
  "choices": [],
  "question": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/monitors/propose#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/monitors/propose.json)