---
title: "What applying the current context would do to this board"
method: POST
path: "/dashboards/{dashboard_id}/context-review"
tags: ["Dashboard v3"]
---

# What applying the current context would do to this board

`POST /dashboards/{dashboard_id}/context-review`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/dashboards/{dashboard_id}/context-review`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

A DRY RUN. The grounding-scoped planner turn runs and nothing is written — not the canvas, not the transcript, not the bake. Returns a job_id; poll /jobs/{id} for the item-level change set plus a `review_id` naming the candidate held server-side.

A context edit is otherwise silently inert on an existing board until someone re-plans it, and the re-plan then rewrites the board with no way to see first what it would do.

`review_id` is null when the context changes nothing. That is an outcome, not a failure: the client says so rather than showing an empty list.

## Path parameters

- `dashboard_id` integer, required

## Request body

- ReviewContextSpec: Dry-run the current context against this board
  - `params` ReviewContextParams
    - `scope` string, nullable: summary | insights | all (default: summary)
    - `note` string, nullable: The user's own steer
    - `fresh` boolean: Re-run the planner instead of reusing a pending review

## Response `201`

Document created, URL follows

- ObjectJobSchema
  - `status_code` integer, nullable
  - `job_id` integer, nullable: Created job id
  - `failure_reason` string, nullable: Failure reason if status is failure

## Other responses

- `202`: Successfully Submitted
- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/fe078afe239b?raw)