playtable_fields

Delete playtable field

Cascade soft-delete of a column. DESTRUCTIVE: cell values are hard-purged (recovery_available_until is always null; spend receipts survive in the credit ledger); re-creating a field with the same slug re-binds existing {{record.<slug>}} references. On 409 delete_blocked: hard blocker = an active workflow version references the slug (pause or edit it first); soft = dependent fields (orphan_dependents) and queued/running cells (cancel_pending_cells). Check include=dependents first.

Contract:

  • MCP tool delete_playtable_field, registry package mcp.playtables/playtable_fields, mount playtables.columns.
  • Operation delete, response envelope delete_cascade.
  • Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API.
delete/api/playtable-fields/{sid}

Request

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

Path parameters

sidstring required

The pt_fd_* sid of the row to delete.

Query parameters

acknowledge[]string[]

Soft-blocker resolution codes the user confirmed. orphan_dependents: dependents keep their source text, their next recalc/run errors until edited. cancel_pending_cells: queued cancelled unbilled; running finish, write discarded.

Response

delete_cascade success envelope.

successtrue required
operation'delete' required
itemobject required
already_deletedboolean required
soft_deletedboolean required

Changes

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