GEgetsales
playtable_field_values

Update playtable field value

Inline cell edit - overwrite value (the only mutable field) to fix a wrong result. Finalizes the cell as done - value:null included (clears, stays done: the manual pin) - bumps finished_at, clears error_msg; a formula-backed cell gets pinned (is_value_from_formula=false - the cascade skips it until an explicit run recomputes). Dependent formula cells recompute; object doc reindexes; cost/provider_sid/meta remain last-run history. 409 while status=running; editing a queued cell is safe.

Contract:

  • MCP tool update_playtable_field_value, registry package mcp.playtables/playtable_field_values, mount playtables.columns.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/playtable-field-values/{sid}

Request

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

Path parameters

sidstring required

Cell (playtable field value) sid (pt_vl_…).

Request body

valuestring nullable

New cell value (canonical string; per-type parsing lives in the field's ES mapping). null clears the value - the cell finalizes as done with value=null (never empty). Only mutable field - an empty PATCH returns 422 nothing_to_update.

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.