GEgetsales
companies

Update company

Partial attribute edit: identity fields, deal_size, tags (full-replace), external_refs. An identity edit that collides with another live account persists and flags the edited row status duplicate, naming the primary in duplicate_of_sid; nothing moves, never a 409. name, logo_url and website are manual observations. Firmographics are field values, not here. status and playtable_sids are service-managed. At least one field, else 422 nothing_to_update.

Contract:

  • MCP tool update_company, registry package mcp.playtables/companies, mount playtables.people.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/companies/{sid}

Request

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

Path parameters

sidstring required

Company sid (cr_co_…).

Request body

namestring nullable

A manual observation that outranks every source until reset; the linked people show it (their items, documents and templates resolve it).

logo_urlstring uri nullable

New logo URL (max 2048), a manual observation; null records a manual none (the domain favicon).

ln_idstring nullable

Identity edit - a collision with another live account flags this row status=duplicate (never a 409); the linked people's documents follow.

ln_nicknamestring nullable

Identity edit - dedup guard re-runs; a page URL is reduced to the slug in place.

websitestring uri nullable

The full URL, a manual observation; domain is not derived on update.

domainstring nullable

Identity edit - dedup guard re-runs; normalized in place.

deal_sizenumber nullable

Deal value (decimal 15,2); null clears it.

tag_sidsstring[] nullable

Full-replace (not a merge).

external_refsobject nullable

Free-form CRM sync hook, full-replace; round-tripped as-is.

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.