Discard Checkpoint
discard_checkpointDiscard a specific draft checkpoint after user confirms it should not become memory. Requires explicit approval to remove the checkpoint.
Instructions
Use when: Human review tool: discard a specific draft checkpoint after the user explicitly confirms it should not become memory. Do not use when: a narrower tool better matches the intent, the project scope is unresolved, or the user has declined the action. Requires: authenticated API authority. Effect: canonical mutation. For the same logical mutation retry, reuse the same idempotencyKey. If the payload or user intent changes, use a new key. Replay returns the first canonical result ID and version; the key never bypasses authorization or expected-version checks. Human approval: required before this action or its canonical follow-up. Then: follow typed result state; review pending proposals/drafts before any canonical apply. On failure: login_required → login; project_not_selected → list_projects/select_project; permission_denied → stop; stale_version or conflict → read current state; projection_pending → report canonical success separately and wait.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirmed | Yes | Must be true after the user explicitly approves discarding this checkpoint. | |
| checkpointId | Yes | Checkpoint draft id returned by checkpoint or review_pending. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| status | Yes | ||
| warnings | Yes | ||
| authority | Yes | ||
| projectId | Yes | ||
| reviewUrl | Yes | ||
| idempotency | Yes | ||
| nextActions | Yes | ||
| reviewRequired | Yes | ||
| canonicalVersion | Yes | ||
| projectionStatus | Yes |