Update company
curl --request PATCH \
--url https://beta.getsales.io/playtables/v1/api/companies/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"name": "<string>",
"logo_url": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>",
"website": "<string>",
"domain": "<string>",
"deal_size": 123,
"tag_sids": [
"<string>"
],
"external_refs": {}
}
'import requests
url = "https://beta.getsales.io/playtables/v1/api/companies/{sid}"
payload = {
"name": "<string>",
"logo_url": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>",
"website": "<string>",
"domain": "<string>",
"deal_size": 123,
"tag_sids": ["<string>"],
"external_refs": {}
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
logo_url: '<string>',
ln_id: '<string>',
ln_nickname: '<string>',
website: '<string>',
domain: '<string>',
deal_size: 123,
tag_sids: ['<string>'],
external_refs: {}
})
};
fetch('https://beta.getsales.io/playtables/v1/api/companies/{sid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://beta.getsales.io/playtables/v1/api/companies/{sid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'logo_url' => '<string>',
'ln_id' => '<string>',
'ln_nickname' => '<string>',
'website' => '<string>',
'domain' => '<string>',
'deal_size' => 123,
'tag_sids' => [
'<string>'
],
'external_refs' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Team-SID: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://beta.getsales.io/playtables/v1/api/companies/{sid}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"logo_url\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\",\n \"website\": \"<string>\",\n \"domain\": \"<string>\",\n \"deal_size\": 123,\n \"tag_sids\": [\n \"<string>\"\n ],\n \"external_refs\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://beta.getsales.io/playtables/v1/api/companies/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"logo_url\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\",\n \"website\": \"<string>\",\n \"domain\": \"<string>\",\n \"deal_size\": 123,\n \"tag_sids\": [\n \"<string>\"\n ],\n \"external_refs\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/playtables/v1/api/companies/{sid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"logo_url\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\",\n \"website\": \"<string>\",\n \"domain\": \"<string>\",\n \"deal_size\": 123,\n \"tag_sids\": [\n \"<string>\"\n ],\n \"external_refs\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"playtable_sids": [
"<string>"
],
"data_source_sid": "<string>",
"data_source_type": "<string>",
"data_source_item_sid": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>",
"context": {
"name": "<string>",
"picture_url": "<string>",
"website": "<string>",
"sources": {}
},
"domain": "<string>",
"deal_size": 123,
"status": "ok",
"status_reason": "<string>",
"duplicate_of_sid": "<string>",
"duplicate_matched_kind": "ln_id",
"tag_sids": [
"<string>"
],
"external_refs": {},
"last_enrich_at": "<string>",
"deleted_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"actor_name": "<string>",
"oauth_client_sid": "<string>",
"reason": "<string>",
"cluster_id": 123,
"trace_id": "<string>"
},
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>",
"pipeline_stage_sid": "<string>",
"pipeline_stage_source": "derived"
},
"updated_fields": [
"<string>"
],
"previous_values": {},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"kept_fields": [
"<string>"
]
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}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 packagemcp.playtables/companies, mountplaytables.people. - Operation
update, response envelopeupdate. - Flags: none.
PATCH
/
api
/
companies
/
{sid}
Update company
curl --request PATCH \
--url https://beta.getsales.io/playtables/v1/api/companies/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"name": "<string>",
"logo_url": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>",
"website": "<string>",
"domain": "<string>",
"deal_size": 123,
"tag_sids": [
"<string>"
],
"external_refs": {}
}
'import requests
url = "https://beta.getsales.io/playtables/v1/api/companies/{sid}"
payload = {
"name": "<string>",
"logo_url": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>",
"website": "<string>",
"domain": "<string>",
"deal_size": 123,
"tag_sids": ["<string>"],
"external_refs": {}
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
logo_url: '<string>',
ln_id: '<string>',
ln_nickname: '<string>',
website: '<string>',
domain: '<string>',
deal_size: 123,
tag_sids: ['<string>'],
external_refs: {}
})
};
fetch('https://beta.getsales.io/playtables/v1/api/companies/{sid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://beta.getsales.io/playtables/v1/api/companies/{sid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'logo_url' => '<string>',
'ln_id' => '<string>',
'ln_nickname' => '<string>',
'website' => '<string>',
'domain' => '<string>',
'deal_size' => 123,
'tag_sids' => [
'<string>'
],
'external_refs' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Team-SID: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://beta.getsales.io/playtables/v1/api/companies/{sid}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"logo_url\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\",\n \"website\": \"<string>\",\n \"domain\": \"<string>\",\n \"deal_size\": 123,\n \"tag_sids\": [\n \"<string>\"\n ],\n \"external_refs\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://beta.getsales.io/playtables/v1/api/companies/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"logo_url\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\",\n \"website\": \"<string>\",\n \"domain\": \"<string>\",\n \"deal_size\": 123,\n \"tag_sids\": [\n \"<string>\"\n ],\n \"external_refs\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/playtables/v1/api/companies/{sid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"logo_url\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\",\n \"website\": \"<string>\",\n \"domain\": \"<string>\",\n \"deal_size\": 123,\n \"tag_sids\": [\n \"<string>\"\n ],\n \"external_refs\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"playtable_sids": [
"<string>"
],
"data_source_sid": "<string>",
"data_source_type": "<string>",
"data_source_item_sid": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>",
"context": {
"name": "<string>",
"picture_url": "<string>",
"website": "<string>",
"sources": {}
},
"domain": "<string>",
"deal_size": 123,
"status": "ok",
"status_reason": "<string>",
"duplicate_of_sid": "<string>",
"duplicate_matched_kind": "ln_id",
"tag_sids": [
"<string>"
],
"external_refs": {},
"last_enrich_at": "<string>",
"deleted_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"actor_name": "<string>",
"oauth_client_sid": "<string>",
"reason": "<string>",
"cluster_id": 123,
"trace_id": "<string>"
},
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>",
"pipeline_stage_sid": "<string>",
"pipeline_stage_source": "derived"
},
"updated_fields": [
"<string>"
],
"previous_values": {},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"kept_fields": [
"<string>"
]
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}Authorizations
Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.
Team scope for tokens that do not carry one. Ignored when the token already names a team.
Path Parameters
Company sid (cr_co_…).
Required string length:
18Pattern:
^cr_co_Body
application/json
Request body of update_company.
A manual observation that outranks every source until reset; the linked people show it (their items, documents and templates resolve it).
Required string length:
1 - 511New logo URL (max 2048), a manual observation; null records a manual none (the domain favicon).
Maximum string length:
2048Identity edit - a collision with another live account flags this row status=duplicate (never a 409); the linked people's documents follow.
Maximum string length:
255Identity edit - dedup guard re-runs; a page URL is reduced to the slug in place.
Maximum string length:
255The full URL, a manual observation; domain is not derived on update.
Maximum string length:
511Identity edit - dedup guard re-runs; normalized in place.
Maximum string length:
255Deal value (decimal 15,2); null clears it.
Full-replace (not a merge).
Required string length:
18Pattern:
^cr_tg_Free-form CRM sync hook, full-replace; round-tripped as-is.
Show child attributes
Show child attributes
Response
update success envelope.
Available options:
true Available options:
update Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.