Slatebox Docs
Browse documentation

Preview a triangle before editing the slate

Send an authenticated dry run and inspect the operation report while the saved board stays untouched.

Open a slate you can edit, copy its ID from the canvas URL, and load a personal API token into your shell from your secret manager. This recipe uses the hosted HTTP API and runs without an engine installation.

: "${SLATEBOX_TOKEN:?Load your personal token into the environment}"
: "${SLATEBOX_SHARE_ID:?Set the ID from your editable canvas URL}"
curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $SLATEBOX_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"dryRun":true,"userMessage":"Add one triangle","plan":{"message":"Place a triangle","operations":[{"kind":"add_nodes","count":1,"shape":"triangle"}]}}' \
  "https://api.slatebox.com/v1/slates/$SLATEBOX_SHARE_ID/operations"

Expect HTTP 200 and JSON with ok, dryRun: true, the slate ID, the materialized operations, and a report. Open the board again. Its saved note count stays the same. A committed edit is a separate request with its own idempotency key.

Open your slate · Personal tokens and authentication