ActionDryRunApi

Preview actions

Preview policy decisions and execution diffs for the approved account without saving a proposal. A kill switch returns blocked policy decisions.

post/agent/workspaces/{workspace}/actions/dry-run

Request

  • Base URL: https://plainrouter.com/api/v1
  • URL: https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions/dry-run
  • Auth: HTTP bearer

Path parameters

workspaceinteger required

The workspace ID

Request body

limitinteger

Maximum complete result actions; the shared JSON byte budget can return fewer.

cursorinteger

Continue using next_cursor. Read saved proposal actions with get_action_batch to avoid another write; dry runs repeat the same inputs.

rationalestring required
idempotency_keystring required
target_source'human_supplied' required
account_idinteger
workspace_idinteger

Response

Evaluated dry-run preview. Result projections share the 80,000-byte MCP JSON budget; defaults are bounded, next_cursor continues complete rows, and oversized single rows are explicitly refused. Plan creative continuation uses the read endpoint; proposal continuation uses the batch read endpoint.

Changes

No recorded changes to this operation across all 2 revisions of this API.