playtables

Stop the runs of a playtable

Stop everything running on one table (Stop all): every unfinished run of it, on every tab, active and waiting, is cancelled through the runs' cancel, waiting ones first. Queued cells go back; cells a worker holds finish and are charged (in_flight_cells_count); no refunds. Call with dry_run:true first and tell the user the numbers. Nothing running: runs []. Formula fills are not runs. One column: cancel_playtable_field_runs; one run: cancel_playtable_run (both on /mcp/playtables/columns).

Contract:

  • MCP tool cancel_playtable_runs, registry package mcp.playtables/playtables, mount playtables.tables.
  • Operation action, response envelope action.
  • Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API.
post/api/playtables/{sid}/cancel-runs

Request

  • Base URL
    https://beta.getsales.io/playtables/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

The table (pt_tb_…) whose runs stop, every tab of it. Another team's is 403.

Request body

dry_runboolean

true: answer the counts (the runs, the queued cells that would go back, the cells still running that finish and are charged) and cancel nothing. Call it first and tell the user the numbers; then call without it.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

Changes

No recorded changes to this operation across all 1 revision of this API.