# Suggestion

The `Suggestion` family — 3 operations.

A suggestion is an offer the platform minted from bounded live reads: why, in plain words; the evidence it looked at; a drafted plan; and an expiry. You see only the suggestions your own permissions could carry out. Taking one opens a scratchpad with the plan; declining one records the reason.

## Operations

| Operation | Kind | What it does |
| --- | --- | --- |
| [declineSuggestion](/reference/suggestion/declineSuggestion/) | mutation | Decline a suggestion — say why, and the desk keeps your reason so it learns. |
| [suggestion](/reference/suggestion/suggestion/) | query | Look up one record — a suggestion — something the desk noticed and drafted a plan for, yours to take or decline. |
| [suggestions](/reference/suggestion/suggestions/) | query | The suggestion list — each entry is a suggestion — something the desk noticed and drafted a plan for, yours to take or decline. |
