curl --request POST \
--url https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"destination": {
"kind": "existing",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"acknowledgedWarnings": [],
"confirmDomain": "<string>",
"previewSignature": "<string>"
}
'import requests
url = "https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move"
payload = {
"destination": {
"kind": "existing",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"acknowledgedWarnings": [],
"confirmDomain": "<string>",
"previewSignature": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
destination: {kind: 'existing', workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
acknowledgedWarnings: [],
confirmDomain: '<string>',
previewSignature: '<string>'
})
};
fetch('https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move', 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://app.searchable.com/api/mcp/pitches/{pitchId}/client-move",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'destination' => [
'kind' => 'existing',
'workspaceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'acknowledgedWarnings' => [
],
'confirmDomain' => '<string>',
'previewSignature' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.searchable.com/api/mcp/pitches/{pitchId}/client-move"
payload := strings.NewReader("{\n \"destination\": {\n \"kind\": \"existing\",\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"acknowledgedWarnings\": [],\n \"confirmDomain\": \"<string>\",\n \"previewSignature\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.post("https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"destination\": {\n \"kind\": \"existing\",\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"acknowledgedWarnings\": [],\n \"confirmDomain\": \"<string>\",\n \"previewSignature\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"destination\": {\n \"kind\": \"existing\",\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"acknowledgedWarnings\": [],\n \"confirmDomain\": \"<string>\",\n \"previewSignature\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}Move a pitch into a client workspace
Move the pitch into a client workspace, as the app’s convert dialog does for a reseller: into an existing client workspace, or into a new one created for it. The pitch becomes a client project with every feature unlocked, its prompts move onto that workspace’s plan allowance, and it cannot be undone. The user’s part is the app’s: they type the pitch’s domain (confirmDomain) and acknowledge each warning the preview listed (acknowledgedWarnings: exactly those codes, [] when it listed none). Send what the user gave, and never fill either in on their behalf. An existing workspace also needs the previewSignature of the preview of that same destination. The API has no confirm step: the request is the decision, so it moves the pitch at once. Look first with POST /api/mcp/pitches/{pitchId}/client-move/preview. Only a reseller’s owner, or a staff-marked admin or super admin operator, can use it, and only while the reseller is in the rollout; everyone else, a pitch that is not an open pitch of the caller’s reseller, and a pitch the caller cannot reach all answer 404 not_found, so the response never says whether the caller is a reseller. Requires a connection minted with the project:manage capability (not the bare write scope). A project-bound key is refused with 403 forbidden: moving a pitch into a client workspace reaches beyond one project. An existing destination’s workspace API access policy is honoured as every write into a workspace honours it: a destination with API access disabled, or whose IP allowlist refuses the request, answers 403 security_policy_denied and nothing moves, and is left out of the options. A new client workspace has no policy yet. 403 security_policy_denied when the pitch’s own workspace has API access disabled or its IP allowlist refuses the request (a caller who is no member of that workspace gets 404 not_found instead). Supports Idempotency-Key replay, scoped to the pitch: a replayed move moves once, a reused key with a different body returns 409 idempotency_conflict, and the same key on another pitch is a new request. Refusals: 409 preview_stale when the pitch or the destination changed since the preview (or no signature was sent for an existing workspace), 409 confirmation_mismatch when confirmDomain is not the pitch’s domain, 409 destination_not_permitted for a workspace the pitch cannot move into; other move refusals carry the move engine’s own code, in lower case.
curl --request POST \
--url https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"destination": {
"kind": "existing",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"acknowledgedWarnings": [],
"confirmDomain": "<string>",
"previewSignature": "<string>"
}
'import requests
url = "https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move"
payload = {
"destination": {
"kind": "existing",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"acknowledgedWarnings": [],
"confirmDomain": "<string>",
"previewSignature": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
destination: {kind: 'existing', workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
acknowledgedWarnings: [],
confirmDomain: '<string>',
previewSignature: '<string>'
})
};
fetch('https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move', 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://app.searchable.com/api/mcp/pitches/{pitchId}/client-move",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'destination' => [
'kind' => 'existing',
'workspaceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'acknowledgedWarnings' => [
],
'confirmDomain' => '<string>',
'previewSignature' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.searchable.com/api/mcp/pitches/{pitchId}/client-move"
payload := strings.NewReader("{\n \"destination\": {\n \"kind\": \"existing\",\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"acknowledgedWarnings\": [],\n \"confirmDomain\": \"<string>\",\n \"previewSignature\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.post("https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"destination\": {\n \"kind\": \"existing\",\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"acknowledgedWarnings\": [],\n \"confirmDomain\": \"<string>\",\n \"previewSignature\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.searchable.com/api/mcp/pitches/{pitchId}/client-move")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"destination\": {\n \"kind\": \"existing\",\n \"workspaceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"acknowledgedWarnings\": [],\n \"confirmDomain\": \"<string>\",\n \"previewSignature\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "unauthorized",
"error": "<string>",
"message": "<string>",
"howToFix": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiresUpgrade": true,
"retryable": true,
"timeout": true,
"quotaExceeded": true,
"current": 123,
"limit": 123,
"bulkLimitExceeded": true,
"requested": 123,
"maxAllowed": 123,
"details": {
"formErrors": [
"<string>"
],
"fieldErrors": {}
},
"opensAt": "2023-11-07T05:31:56Z",
"existing": {},
"quotaConflict": {
"current": 123,
"pitchPromptCount": 123,
"limit": 123,
"shortfall": 123
}
}Authorizations
A Searchable API key, created under Manage Account → Integrations → API Keys. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.
Headers
Optional client-generated key (e.g. a UUID). Retrying with the same key within 24h replays the original stored response (X-Idempotent-Replay: true) instead of repeating the side effect. See Idempotency.
Path Parameters
Body
The codes of the warnings the user confirmed: exactly the codes the preview listed, and [] when it listed none.
32SAME_WORKSPACE, DESTINATION_OWNER_MISSING, PROJECT_STATE_UNSUPPORTED, CREATOR_DOMAIN_CONFLICT, SOURCE_DOMAIN_CONFLICT, ACCESS_GRANTS_WILL_BE_REVOKED, ACCESS_BINDINGS_WILL_MOVE, STORAGE_OBJECT_MISSING, QUOTA_PROJECTS_EXCEEDED, QUOTA_PROMPTS_EXCEEDED, IN_FLIGHT_AGENT_RUNS, SAME_DOMAIN_PROJECTS, SCHEDULED_REPORTS_WILL_STOP Response
The pitch is a client project in the destination workspace now.