GEgetsales
playtables

Update playtable

Rename a table, edit its description, or replace config (full-replace of the Value). name is re-checked against the (team_sid, name) guard - 409 duplicate_rejected if taken. Toggling config.auto_run affects only FUTURE row inserts; already-present rows need an explicit run (playtable-runs). sid, team_sid and the two default-view pointers are read-only (silently rejected). At least one field required, else 422 nothing_to_update.

Contract:

  • MCP tool update_playtable, registry package mcp.playtables/playtables, mount playtables.tables.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/playtables/{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 sid (pt_tb_…).

Request body

namestring

New table name (1..255), unique per team.

descriptionstring nullable

null resets the description.

agent_sidstring nullable

Pick the AI SDR for this table (ub_ag_…); null = back to the team's default. Reaches the table's open threads at their next turn.

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.