GEgetsales
playtable_field_values

Write playtable field value

Write a cell by natural key (column sid + row sid), not by cell sid: the way to fill an EMPTY cell, which has no row and no sid until written (update_playtable_field_value needs one). Same semantics as update: the cell finalizes as done (value null = a manual clear), error_msg clears, a formula cell is pinned, the first write over a system value snapshots it for reset. Works on an existing cell too. 404 on another team's column, 422 when the row is outside its table, 409 while the cell runs.

Contract:

  • MCP tool write_playtable_field_value, registry package mcp.playtables/playtable_field_values, mount playtables.columns.
  • Operation update, response envelope update.
  • Flags: none.
post/api/playtable-field-values/write

Request

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

Request body

playtable_field_sidstring required

The column (pt_fd_…); the table and the object type derive from it. Unknown or another team's: 404.

object_sidstring required

The row: a person (cr_pp_…) or a company (cr_co_…) that belongs to the column's table (422 otherwise).

valuestring nullable required

The value to write, canonical string (max 65535). The key is required: null clears the cell, which stays done with value null, never empty.

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.