Update workspace profile
curl --request PATCH \
--url https://beta.getsales.io/id/v1/api/workspace-profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"company": {
"name": "<string>",
"tagline": "<string>",
"industry": "<string>",
"people_count": 50000000,
"founded_year": 1001,
"location": "<string>",
"website": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>"
},
"who_buys": {
"roles": [
"<string>"
],
"industries": [
"<string>"
],
"company_size": "<string>",
"regions": [
"<string>"
],
"example_clients": [
"<string>"
]
},
"offer": {
"what_we_sell": "<string>",
"proof": "<string>",
"price": "<string>"
},
"confirm": true
}
'import requests
url = "https://beta.getsales.io/id/v1/api/workspace-profile"
payload = {
"company": {
"name": "<string>",
"tagline": "<string>",
"industry": "<string>",
"people_count": 50000000,
"founded_year": 1001,
"location": "<string>",
"website": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>"
},
"who_buys": {
"roles": ["<string>"],
"industries": ["<string>"],
"company_size": "<string>",
"regions": ["<string>"],
"example_clients": ["<string>"]
},
"offer": {
"what_we_sell": "<string>",
"proof": "<string>",
"price": "<string>"
},
"confirm": True
}
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({
company: {
name: '<string>',
tagline: '<string>',
industry: '<string>',
people_count: 50000000,
founded_year: 1001,
location: '<string>',
website: '<string>',
ln_id: '<string>',
ln_nickname: '<string>'
},
who_buys: {
roles: ['<string>'],
industries: ['<string>'],
company_size: '<string>',
regions: ['<string>'],
example_clients: ['<string>']
},
offer: {what_we_sell: '<string>', proof: '<string>', price: '<string>'},
confirm: true
})
};
fetch('https://beta.getsales.io/id/v1/api/workspace-profile', 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/id/v1/api/workspace-profile",
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([
'company' => [
'name' => '<string>',
'tagline' => '<string>',
'industry' => '<string>',
'people_count' => 50000000,
'founded_year' => 1001,
'location' => '<string>',
'website' => '<string>',
'ln_id' => '<string>',
'ln_nickname' => '<string>'
],
'who_buys' => [
'roles' => [
'<string>'
],
'industries' => [
'<string>'
],
'company_size' => '<string>',
'regions' => [
'<string>'
],
'example_clients' => [
'<string>'
]
],
'offer' => [
'what_we_sell' => '<string>',
'proof' => '<string>',
'price' => '<string>'
],
'confirm' => true
]),
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/id/v1/api/workspace-profile"
payload := strings.NewReader("{\n \"company\": {\n \"name\": \"<string>\",\n \"tagline\": \"<string>\",\n \"industry\": \"<string>\",\n \"people_count\": 50000000,\n \"founded_year\": 1001,\n \"location\": \"<string>\",\n \"website\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\"\n },\n \"who_buys\": {\n \"roles\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"company_size\": \"<string>\",\n \"regions\": [\n \"<string>\"\n ],\n \"example_clients\": [\n \"<string>\"\n ]\n },\n \"offer\": {\n \"what_we_sell\": \"<string>\",\n \"proof\": \"<string>\",\n \"price\": \"<string>\"\n },\n \"confirm\": true\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/id/v1/api/workspace-profile")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"company\": {\n \"name\": \"<string>\",\n \"tagline\": \"<string>\",\n \"industry\": \"<string>\",\n \"people_count\": 50000000,\n \"founded_year\": 1001,\n \"location\": \"<string>\",\n \"website\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\"\n },\n \"who_buys\": {\n \"roles\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"company_size\": \"<string>\",\n \"regions\": [\n \"<string>\"\n ],\n \"example_clients\": [\n \"<string>\"\n ]\n },\n \"offer\": {\n \"what_we_sell\": \"<string>\",\n \"proof\": \"<string>\",\n \"price\": \"<string>\"\n },\n \"confirm\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/id/v1/api/workspace-profile")
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 \"company\": {\n \"name\": \"<string>\",\n \"tagline\": \"<string>\",\n \"industry\": \"<string>\",\n \"people_count\": 50000000,\n \"founded_year\": 1001,\n \"location\": \"<string>\",\n \"website\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\"\n },\n \"who_buys\": {\n \"roles\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"company_size\": \"<string>\",\n \"regions\": [\n \"<string>\"\n ],\n \"example_clients\": [\n \"<string>\"\n ]\n },\n \"offer\": {\n \"what_we_sell\": \"<string>\",\n \"proof\": \"<string>\",\n \"price\": \"<string>\"\n },\n \"confirm\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"company": {
"name": "<string>",
"tagline": "<string>",
"industry": "<string>",
"people_count": 123,
"founded_year": 123,
"location": "<string>",
"website": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>"
},
"who_buys": {
"roles": [
"<string>"
],
"industries": [
"<string>"
],
"company_size": "<string>",
"regions": [
"<string>"
],
"example_clients": [
"<string>"
]
},
"offer": {
"what_we_sell": "<string>",
"proof": "<string>",
"price": "<string>"
},
"sources": {},
"confirmed_at": "<string>",
"version": 123,
"created_at": "<string>",
"updated_at": "<string>"
},
"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>"
}
}workspace_profiles
Update workspace profile
Write the workspace profile: a section given (company, who_buys, offer) replaces that section whole, so read it first and send it back with the fields changed; source stamps every field of the sections given (website, linkedin_company, linkedin_profile, person for the person’s own words, creator for an inference; default person); confirm true marks the profile confirmed. The first write creates the row. 422 unknown_field on a key outside a section’s shape, website_invalid, ln_nickname_invalid.
Contract:
- MCP tool
update_workspace_profile, registry packagemcp.id/workspace_profiles, mountid.identity. - Operation
update, response envelopeupdate. - Flags: none.
PATCH
/
api
/
workspace-profile
Update workspace profile
curl --request PATCH \
--url https://beta.getsales.io/id/v1/api/workspace-profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"company": {
"name": "<string>",
"tagline": "<string>",
"industry": "<string>",
"people_count": 50000000,
"founded_year": 1001,
"location": "<string>",
"website": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>"
},
"who_buys": {
"roles": [
"<string>"
],
"industries": [
"<string>"
],
"company_size": "<string>",
"regions": [
"<string>"
],
"example_clients": [
"<string>"
]
},
"offer": {
"what_we_sell": "<string>",
"proof": "<string>",
"price": "<string>"
},
"confirm": true
}
'import requests
url = "https://beta.getsales.io/id/v1/api/workspace-profile"
payload = {
"company": {
"name": "<string>",
"tagline": "<string>",
"industry": "<string>",
"people_count": 50000000,
"founded_year": 1001,
"location": "<string>",
"website": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>"
},
"who_buys": {
"roles": ["<string>"],
"industries": ["<string>"],
"company_size": "<string>",
"regions": ["<string>"],
"example_clients": ["<string>"]
},
"offer": {
"what_we_sell": "<string>",
"proof": "<string>",
"price": "<string>"
},
"confirm": True
}
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({
company: {
name: '<string>',
tagline: '<string>',
industry: '<string>',
people_count: 50000000,
founded_year: 1001,
location: '<string>',
website: '<string>',
ln_id: '<string>',
ln_nickname: '<string>'
},
who_buys: {
roles: ['<string>'],
industries: ['<string>'],
company_size: '<string>',
regions: ['<string>'],
example_clients: ['<string>']
},
offer: {what_we_sell: '<string>', proof: '<string>', price: '<string>'},
confirm: true
})
};
fetch('https://beta.getsales.io/id/v1/api/workspace-profile', 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/id/v1/api/workspace-profile",
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([
'company' => [
'name' => '<string>',
'tagline' => '<string>',
'industry' => '<string>',
'people_count' => 50000000,
'founded_year' => 1001,
'location' => '<string>',
'website' => '<string>',
'ln_id' => '<string>',
'ln_nickname' => '<string>'
],
'who_buys' => [
'roles' => [
'<string>'
],
'industries' => [
'<string>'
],
'company_size' => '<string>',
'regions' => [
'<string>'
],
'example_clients' => [
'<string>'
]
],
'offer' => [
'what_we_sell' => '<string>',
'proof' => '<string>',
'price' => '<string>'
],
'confirm' => true
]),
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/id/v1/api/workspace-profile"
payload := strings.NewReader("{\n \"company\": {\n \"name\": \"<string>\",\n \"tagline\": \"<string>\",\n \"industry\": \"<string>\",\n \"people_count\": 50000000,\n \"founded_year\": 1001,\n \"location\": \"<string>\",\n \"website\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\"\n },\n \"who_buys\": {\n \"roles\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"company_size\": \"<string>\",\n \"regions\": [\n \"<string>\"\n ],\n \"example_clients\": [\n \"<string>\"\n ]\n },\n \"offer\": {\n \"what_we_sell\": \"<string>\",\n \"proof\": \"<string>\",\n \"price\": \"<string>\"\n },\n \"confirm\": true\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/id/v1/api/workspace-profile")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"company\": {\n \"name\": \"<string>\",\n \"tagline\": \"<string>\",\n \"industry\": \"<string>\",\n \"people_count\": 50000000,\n \"founded_year\": 1001,\n \"location\": \"<string>\",\n \"website\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\"\n },\n \"who_buys\": {\n \"roles\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"company_size\": \"<string>\",\n \"regions\": [\n \"<string>\"\n ],\n \"example_clients\": [\n \"<string>\"\n ]\n },\n \"offer\": {\n \"what_we_sell\": \"<string>\",\n \"proof\": \"<string>\",\n \"price\": \"<string>\"\n },\n \"confirm\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/id/v1/api/workspace-profile")
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 \"company\": {\n \"name\": \"<string>\",\n \"tagline\": \"<string>\",\n \"industry\": \"<string>\",\n \"people_count\": 50000000,\n \"founded_year\": 1001,\n \"location\": \"<string>\",\n \"website\": \"<string>\",\n \"ln_id\": \"<string>\",\n \"ln_nickname\": \"<string>\"\n },\n \"who_buys\": {\n \"roles\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"company_size\": \"<string>\",\n \"regions\": [\n \"<string>\"\n ],\n \"example_clients\": [\n \"<string>\"\n ]\n },\n \"offer\": {\n \"what_we_sell\": \"<string>\",\n \"proof\": \"<string>\",\n \"price\": \"<string>\"\n },\n \"confirm\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"company": {
"name": "<string>",
"tagline": "<string>",
"industry": "<string>",
"people_count": 123,
"founded_year": 123,
"location": "<string>",
"website": "<string>",
"ln_id": "<string>",
"ln_nickname": "<string>"
},
"who_buys": {
"roles": [
"<string>"
],
"industries": [
"<string>"
],
"company_size": "<string>",
"regions": [
"<string>"
],
"example_clients": [
"<string>"
]
},
"offer": {
"what_we_sell": "<string>",
"proof": "<string>",
"price": "<string>"
},
"sources": {},
"confirmed_at": "<string>",
"version": 123,
"created_at": "<string>",
"updated_at": "<string>"
},
"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.
Body
application/json
Request body of update_workspace_profile.
The company section, replaced whole: a key left out becomes null (or an empty list), so read the profile first and send the section back with the fields changed.
Show child attributes
Show child attributes
The who-buys section, replaced whole (the same rule).
Show child attributes
Show child attributes
The offer section, replaced whole (the same rule).
Show child attributes
Show child attributes
Stamps every field of the sections given: website, linkedin_company, linkedin_profile for what a read said, person for the person's own words, creator for an inference; default person. A value the person wrote stands against any other source (kept_fields).
Available options:
linkedin_company, linkedin_profile, website, person, creator True marks the profile confirmed (the person said the cards are right); sent alone, it confirms without a write.
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.