playtable_views

Update playtable view

Partially update a view: name, columns, sort, filter - each JSON field is replaced whole. playtable_sid and object_type are immutable (readonly fields are silently rejected); at least one field required (422 nothing_to_update). WARNING: if workflow sources consume this view, a filter change retargets those live audiences from the poller next cycle - read include=workflow_sources first and confirm with the user.

Contract:

  • MCP tool update_playtable_view, registry package mcp.playtables/playtable_views, mount playtables.tables.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/playtable-views/{sid}

Request

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

Path parameters

sidstring required

Playtable view sid (pt_vw_…).

Request body

namestring

New view name; unique per (playtable, object_type).

Response

update success envelope.

successtrue required
operation'update' required
updated_fieldsstring[] required
previous_valuesobject required
kept_fieldsstring[]

The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.

Changes

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