---
title: "Reset playtable field value"
method: POST
path: "/api/playtable-field-values/{sid}/reset"
tags: ["playtable_field_values"]
---

# Reset playtable field value

`POST /api/playtable-field-values/{sid}/reset`

## Request

- Base URL: `https://beta.getsales.io/playtables/v1`
- URL: `https://beta.getsales.io/playtables/v1/api/playtable-field-values/{sid}/reset`
- Auth: HTTP bearer and API key in header `Team-SID`

Undo a manual overwrite: restore the system value the first edit snapshotted (original_value), clear the edited marker, un-pin a formula cell. 409 unless is_overwritten; 409 while the cell runs.

Contract:
- MCP tool `reset_playtable_field_value`, registry package `mcp.playtables/playtable_field_values`, mount `playtables.columns`.
- Operation `update`, response envelope `update`.
- Flags: none.

## Path parameters

- `sid` string, required: Cell (playtable field value) sid (pt_vl_…).

## Response `200`

`update` success envelope.

- ResetPlaytableFieldValueResponse
  - `success` true, required
  - `operation` 'update', required
  - `item` object, required
    - `sid` string, required
    - `team_sid` string, required
    - `playtable_sid` string, required
    - `object_type` 'people' | 'company', required
    - `object_sid` string, required
    - `playtable_field_sid` string, required
    - `value` string, nullable, required
    - `is_value_from_formula` boolean, required
    - `original_value` string, nullable, required: The system-produced value the FIRST manual overwrite snapshotted, what reset restores; null unless is_overwritten. The list surface nulls it like meta: read it on get, update, write and reset.
    - `is_overwritten` boolean, required: The current value is a manual write over a system-produced one: the edited marker, and the one state reset accepts.
    - `is_not_valid` boolean, required: A manually written value that could not be converted to the column's type (text in a number column), stored raw and flagged; system writers coerce or null instead.
    - `status` 'empty' | 'queued' | 'running' | 'done' | 'error' | 'run_condition_not_met', required
    - `cost` number, nullable, required
    - `provider_sid` string, nullable, required
    - `meta` object, nullable, required
      - `run_sid` string, nullable, required
      - `steps` object[], required
        - `step_index` number, required
        - `tool_sid` string, required
        - `status` 'success' | 'failed' | 'skipped', required
        - `cost` number, required
        - `error` string, nullable, required
        - `finished_at` string, nullable, required
        - `verdict` string, nullable
        - `email` string, nullable
    - `error_msg` string, nullable, required
    - `finished_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
  - `updated_fields` string[], required
  - `previous_values` object, required
  - `kept_fields` string[]: The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.
  - `meta` object, required
    - `trace_id` string, required: UUID v7; same 128-bit value as the X-Trace-Id header.
    - `span_id` string, required: 16 hex chars, root span of this request.
    - `timestamp` string, required: ISO 8601 UTC (Y-m-dTH:i:sZ), response time.
    - `duration_ms` integer, required: Server-side wall clock.
    - `team_sid` string, nullable: The team this call ran in (the token team, or the team_sid override). Null when unauthenticated; absent from pre-2026-08-20 backends.
    - `actor_type` string, nullable: user | agent | api_key | system. Null when unauthenticated; absent from pre-2026-08-20 backends.

## Other responses

- `4XX`: MCP error envelope. `error.code` is one of validation_failed, nothing_to_update, not_found, relation_not_found, invalid_transition, limit_exceeded, payment_required, duplicate_rejected, conflict, delete_blocked, unauthorized, forbidden, rate_limited, not_implemented.
- `5XX`: MCP error envelope with `error.code` internal_error or service_unavailable.

---

[API](https://skmtc.dev/getsales/apis/getsales-public-contract-gs-service-playtables.md) - [All operations](https://skmtc.dev/getsales/apis/getsales-public-contract-gs-service-playtables/llms.txt) - [OpenAPI document](https://skmtc.dev/getsales/apis/getsales-public-contract-gs-service-playtables/revisions/aa394506515d?raw)