THE TAKEAWAY

A dry run validates a request without producing live effects under the service’s contract. It does not guarantee future capacity or outcomes.

01STORY BRIEFThe idea in three screens.3 SCREENS
THE SIGNAL

A preview must know what it does not simulate.

A dry run validates a request without producing live effects under the service’s contract.

1 / 3 · YOUR OWN PACE

In TokPortal MCP, dry_run belongs at the top argument level, not inside body. The local version must support that contract. Read response fields for simulated and actual charges. Preview identifiers remain synthetic: moving live requires creating and using actual resources.

Show the mode, request and reported charges in the human-readable result. Do not say account created when the service only validated a preview. That wording prevents another agent from continuing work against an imaginary resource. The boundary should be both technical and understandable in the report, especially when output is copied into another task without the full execution history attached.

A preview should answer the expensive questions

A dry run is valuable when it shows what the live operation would target, create and cost without performing those side effects. Its contract should say which validations are real and which outcomes remain unknowable until execution. A preview that merely echoes the request can still be useful, but it must not be presented as proof that the live action will succeed. Inspect the documented response fields and retain the exact proposed inputs so the eventual approval refers to a concrete operation.

THE IDEA, UNPACKED

A preview is a versioned proposal

  1. 01
    Prepare

    Freeze the intended inputs and destination.

  2. 02
    Inspect

    Review supported validation, scope and cost.

  3. 03
    Execute

    Use the approved version and verify its result.

Editorial model: a way to reason about the process, not measured platform results.

Bind the approved preview to the execution version. If the country, account, asset or quantity changes afterwards, the old preview no longer describes the new request. Recheck the fields that determine scope and cost before proceeding. Keep credentials out of logs and distinguish a preview identifier from a completed order identifier. For TokPortal, consult the current sandbox and MCP documentation for supported dry-run behaviour rather than assuming every tool has identical semantics. The point is to make consequences legible before execution and the eventual result traceable afterwards.

INSIDE TOKPORTAL

From the idea to the actual workflow.

Product screens, documented tools and a practical way to connect them.

WORKBENCH / SANDBOXDOCUMENTED · 2026-09-09

What the sandbox actually guarantees

The official sandbox page makes a useful boundary explicit: real request validation and pricing, with no created task or charge. This is an operational preview, not a simulation of TikTok reach.

Official TokPortal sandbox documentation explaining the dry-run header and simulated requests.
Public sandbox documentation, captured 9 September 2026. Product ↗
REST EQUIVALENTPOST /api/ext/bundles + X-TokPortal-Dry-Run: true
ANNOTATED EXAMPLE
RESPONSE SHAPE
{
  "dry_run": true,
  "dry_run_notice": "<read the actual notice returned>",
  "credits_would_charge": "<workspace-specific quote>",
  "credits_charged": 0
}

The fields shown are an annotated response shape. No live quote was requested for this article. Use the actual response from your connected workspace and keep any synthetic identifiers out of a live workflow.

  1. 01
    Validation

    Invalid inputs still return real validation errors.

  2. 02
    Pricing

    The quoted cost uses the same server-side pricing logic; the preview does not charge it.

  3. 03
    Distribution

    A successful preview says nothing about the reach, retention or sales a future post will generate.

READ THE CONTRACT sandbox ↗
“A preview must know what it does not simulate.”
02FIELD KITFrom concept to practice.2 SCREENS
PUT IT TO WORK / 1

Check version and preview response.

Adapt this to your audience, budget and test scope.

1 / 2 · YOUR OWN PACE

Put it to work.

  1. 01Check version and preview response.
  2. 02Keep an explicit boundary before live execution.

Notes & sources.

The limit. A successful preview neither authorizes spending nor reserves capacity.

SOURCES & PROVENANCE

THE ORGANIC CLUB is an editorial project initiated by TokPortal. That relationship is separate from the evidence behind claims. Editorial signatures and image credits are explained in our policy. Our editorial policy →

THE CURRENT CONTINUES

API Retry Safety: Avoid Duplicate Social Publishing Operations

Next article ↗