Update data source
curl --request PATCH \
--url https://beta.getsales.io/playtables/v1/api/data-sources/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"name": "<string>",
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"payload": {
"prompt": "<string>",
"per_company_limit": 13,
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"url": "<string>",
"records_path": "<string>"
},
"tag_sids": [
"<string>"
],
"add_tags_to_duplicate": true,
"qualify": {
"on": true,
"criterion": "<string>"
},
"sender_profile_sid": "<string>"
}
'import requests
url = "https://beta.getsales.io/playtables/v1/api/data-sources/{sid}"
payload = {
"name": "<string>",
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"payload": {
"prompt": "<string>",
"per_company_limit": 13,
"window": { "days": 7 },
"relevance": { "prompt": "<string>" },
"collect": {
"reactions": True,
"comments": True,
"reposts": True
},
"url": "<string>",
"records_path": "<string>"
},
"tag_sids": ["<string>"],
"add_tags_to_duplicate": True,
"qualify": {
"on": True,
"criterion": "<string>"
},
"sender_profile_sid": "<string>"
}
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>',
field_mapping: [{source: '<string>', target: '<string>', name: '<string>'}],
payload: {
prompt: '<string>',
per_company_limit: 13,
window: {days: 7},
relevance: {prompt: '<string>'},
collect: {reactions: true, comments: true, reposts: true},
url: '<string>',
records_path: '<string>'
},
tag_sids: ['<string>'],
add_tags_to_duplicate: true,
qualify: {on: true, criterion: '<string>'},
sender_profile_sid: '<string>'
})
};
fetch('https://beta.getsales.io/playtables/v1/api/data-sources/{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/data-sources/{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>',
'field_mapping' => [
[
'source' => '<string>',
'target' => '<string>',
'name' => '<string>'
]
],
'payload' => [
'prompt' => '<string>',
'per_company_limit' => 13,
'window' => [
'days' => 7
],
'relevance' => [
'prompt' => '<string>'
],
'collect' => [
'reactions' => true,
'comments' => true,
'reposts' => true
],
'url' => '<string>',
'records_path' => '<string>'
],
'tag_sids' => [
'<string>'
],
'add_tags_to_duplicate' => true,
'qualify' => [
'on' => true,
'criterion' => '<string>'
],
'sender_profile_sid' => '<string>'
]),
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/data-sources/{sid}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"payload\": {\n \"prompt\": \"<string>\",\n \"per_company_limit\": 13,\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"url\": \"<string>\",\n \"records_path\": \"<string>\"\n },\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n },\n \"sender_profile_sid\": \"<string>\"\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/data-sources/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"payload\": {\n \"prompt\": \"<string>\",\n \"per_company_limit\": 13,\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"url\": \"<string>\",\n \"records_path\": \"<string>\"\n },\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n },\n \"sender_profile_sid\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/playtables/v1/api/data-sources/{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 \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"payload\": {\n \"prompt\": \"<string>\",\n \"per_company_limit\": 13,\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"url\": \"<string>\",\n \"records_path\": \"<string>\"\n },\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n },\n \"sender_profile_sid\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"playtable_sid": "<string>",
"name": "<string>",
"type": "ai_search",
"object_type": "people",
"sender_profile_sid": "<string>",
"ingest_key": "<string>",
"payload": {
"platform": "linkedin",
"surface": "search",
"repeat": "hourly",
"mode": "create",
"target": "post",
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"posts": [
{
"urn": "<string>",
"title": "<string>",
"published_at": "<string>",
"verdict": "match",
"verdict_reason": "<string>"
}
]
},
"field_mapping": [
{
"source": "<string>",
"target_kind": "people_attribute",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": [
"<string>"
],
"qualify": {
"on": true,
"criterion": "<string>"
},
"on_duplicate": "skip",
"add_tags_to_duplicate": true,
"status": "draft",
"status_reason": "<string>",
"next_collect_at": "<string>",
"created_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>"
},
"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>"
},
"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>"
}
}data_sources
Update data source
Partial edit of a source: rename, pause or resume (status active | paused), the mapping of rows not yet promoted, tags, duplicate policy, gate, or another sender profile for a sender_search or a post_engagement. type, object_type and playtable_sid are immutable. A payload patch names only what its kind lets a caller change; payload.prompt rule plan_built and payload.url rule agreement mean the change is a new source. At least one field, else 422 nothing_to_update.
Contract:
- MCP tool
update_data_source, registry packagemcp.playtables/data_sources, mountplaytables.sources. - Operation
update, response envelopeupdate. - Flags: none.
PATCH
/
api
/
data-sources
/
{sid}
Update data source
curl --request PATCH \
--url https://beta.getsales.io/playtables/v1/api/data-sources/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"name": "<string>",
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"payload": {
"prompt": "<string>",
"per_company_limit": 13,
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"url": "<string>",
"records_path": "<string>"
},
"tag_sids": [
"<string>"
],
"add_tags_to_duplicate": true,
"qualify": {
"on": true,
"criterion": "<string>"
},
"sender_profile_sid": "<string>"
}
'import requests
url = "https://beta.getsales.io/playtables/v1/api/data-sources/{sid}"
payload = {
"name": "<string>",
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"payload": {
"prompt": "<string>",
"per_company_limit": 13,
"window": { "days": 7 },
"relevance": { "prompt": "<string>" },
"collect": {
"reactions": True,
"comments": True,
"reposts": True
},
"url": "<string>",
"records_path": "<string>"
},
"tag_sids": ["<string>"],
"add_tags_to_duplicate": True,
"qualify": {
"on": True,
"criterion": "<string>"
},
"sender_profile_sid": "<string>"
}
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>',
field_mapping: [{source: '<string>', target: '<string>', name: '<string>'}],
payload: {
prompt: '<string>',
per_company_limit: 13,
window: {days: 7},
relevance: {prompt: '<string>'},
collect: {reactions: true, comments: true, reposts: true},
url: '<string>',
records_path: '<string>'
},
tag_sids: ['<string>'],
add_tags_to_duplicate: true,
qualify: {on: true, criterion: '<string>'},
sender_profile_sid: '<string>'
})
};
fetch('https://beta.getsales.io/playtables/v1/api/data-sources/{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/data-sources/{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>',
'field_mapping' => [
[
'source' => '<string>',
'target' => '<string>',
'name' => '<string>'
]
],
'payload' => [
'prompt' => '<string>',
'per_company_limit' => 13,
'window' => [
'days' => 7
],
'relevance' => [
'prompt' => '<string>'
],
'collect' => [
'reactions' => true,
'comments' => true,
'reposts' => true
],
'url' => '<string>',
'records_path' => '<string>'
],
'tag_sids' => [
'<string>'
],
'add_tags_to_duplicate' => true,
'qualify' => [
'on' => true,
'criterion' => '<string>'
],
'sender_profile_sid' => '<string>'
]),
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/data-sources/{sid}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"payload\": {\n \"prompt\": \"<string>\",\n \"per_company_limit\": 13,\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"url\": \"<string>\",\n \"records_path\": \"<string>\"\n },\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n },\n \"sender_profile_sid\": \"<string>\"\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/data-sources/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"payload\": {\n \"prompt\": \"<string>\",\n \"per_company_limit\": 13,\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"url\": \"<string>\",\n \"records_path\": \"<string>\"\n },\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n },\n \"sender_profile_sid\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/playtables/v1/api/data-sources/{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 \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"payload\": {\n \"prompt\": \"<string>\",\n \"per_company_limit\": 13,\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"url\": \"<string>\",\n \"records_path\": \"<string>\"\n },\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n },\n \"sender_profile_sid\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"playtable_sid": "<string>",
"name": "<string>",
"type": "ai_search",
"object_type": "people",
"sender_profile_sid": "<string>",
"ingest_key": "<string>",
"payload": {
"platform": "linkedin",
"surface": "search",
"repeat": "hourly",
"mode": "create",
"target": "post",
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"posts": [
{
"urn": "<string>",
"title": "<string>",
"published_at": "<string>",
"verdict": "match",
"verdict_reason": "<string>"
}
]
},
"field_mapping": [
{
"source": "<string>",
"target_kind": "people_attribute",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": [
"<string>"
],
"qualify": {
"on": true,
"criterion": "<string>"
},
"on_duplicate": "skip",
"add_tags_to_duplicate": true,
"status": "draft",
"status_reason": "<string>",
"next_collect_at": "<string>",
"created_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>"
},
"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>"
},
"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
Data source sid (ds_sc_…).
Required string length:
18Pattern:
^ds_sc_Body
application/json
Request body of update_data_source.
New display name (1..255).
Required string length:
1 - 255User transitions only: pause / resume, and failed to active (re-arms the collect clock after a config fix). Anything else is 422 invalid_transition; completed is system-set.
Available options:
active, paused Full-replace of the mapping; affects pending + retried rows only, never already-promoted ones.
Show child attributes
Show child attributes
Merged into the stored payload, only the keys the kind lets a caller change: ai_search {prompt}, sender_search {repeat, url}, post_engagement {repeat, window, relevance, collect}, find_people {per_company_limit, prompt}, webhook {records_path}; else 422.
Show child attributes
Show child attributes
Full-replace of the tag array; applies to future promotions.
Required string length:
18Pattern:
^cr_tg_New duplicate-person policy for the rows promoted from now on.
Available options:
skip, move Merge tag_sids onto matched duplicates from now on.
The whole {on, criterion} block, or null to switch the check off; applies to rows not yet promoted.
Show child attributes
Show child attributes
Reassign the sender profile of a sender_search or a post_engagement (ub_sp_): the checks run again (linkedin_account_missing, sales_nav_required, recruiter_required, recruiter_signed_out). Those two kinds must keep one; any other kind keeps it null.
Required string length:
18Pattern:
^ub_sp_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.