curl --request POST \
--url https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "seed",
"expectedEligibilityDigest": "<string>"
}
'import requests
url = "https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad"
payload = {
"mode": "seed",
"expectedEligibilityDigest": "<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({mode: 'seed', expectedEligibilityDigest: '<string>'})
};
fetch('https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad', 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.harmonica.chat/api/v1/sessions/{id}/scratchpad",
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([
'mode' => 'seed',
'expectedEligibilityDigest' => '<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.harmonica.chat/api/v1/sessions/{id}/scratchpad"
payload := strings.NewReader("{\n \"mode\": \"seed\",\n \"expectedEligibilityDigest\": \"<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.harmonica.chat/api/v1/sessions/{id}/scratchpad")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"mode\": \"seed\",\n \"expectedEligibilityDigest\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad")
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 \"mode\": \"seed\",\n \"expectedEligibilityDigest\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "completed",
"themes": 123,
"participants": 123,
"batches_processed": 123,
"batches_total": 123,
"eligibility_digest": "<string>",
"needs_rebuild": true
}{
"error": {
"code": "validation_error",
"message": "Unknown scratchpad mode"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key"
}
}{
"error": {
"code": "forbidden",
"message": "You don't have access to this session"
}
}{
"error": {
"code": "not_found",
"message": "Session not found"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}Seed, inspect or rebuild the listening map
Trigger cross-pollination scratchpad seeding or update for a session. The scratchpad tracks themes, emerging consensus, open tensions, and declared-question coverage from currently included conversations.
Modes:
seed(default): Process all user messages from scratch. Resumes from existing progress if the session was partially seeded.update: Process only new messages since the last update.status: Return current scratchpad state without processing. Includeseligibility_digestfor an optimistic rebuild andneeds_rebuild.rebuild: Discard the previous map, resume offset and accumulated completeness. Requires the currentexpectedEligibilityDigestfrom status.
Requires editor role. The map is maintained regardless of cross-pollination;
that setting controls injection into participant conversations.
Changing response inclusion invalidates this map and maps seeded from it.
Legacy maps without input receipts and maps whose context sources changed
are withheld until deliberately refreshed. Context source versions are
checked before analysis, publication and use in participant prompts.
An automatic update cannot restart that backfill; request an explicit
seed or rebuild. Stale in-flight writes cannot restore removed input.
Referenced maps must be refreshed first. Session-reference cycles require
removing a reference in the cycle before rebuilding; cyclic reconstruction
is not supported.
For large sessions, seeding may take multiple calls (up to 5 minutes per call). Each batch is persisted to the database, so partial progress survives timeouts. Processing stops at the first failed batch so the resume offset never skips missing evidence. Re-call explicitly to continue.
curl --request POST \
--url https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "seed",
"expectedEligibilityDigest": "<string>"
}
'import requests
url = "https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad"
payload = {
"mode": "seed",
"expectedEligibilityDigest": "<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({mode: 'seed', expectedEligibilityDigest: '<string>'})
};
fetch('https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad', 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.harmonica.chat/api/v1/sessions/{id}/scratchpad",
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([
'mode' => 'seed',
'expectedEligibilityDigest' => '<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.harmonica.chat/api/v1/sessions/{id}/scratchpad"
payload := strings.NewReader("{\n \"mode\": \"seed\",\n \"expectedEligibilityDigest\": \"<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.harmonica.chat/api/v1/sessions/{id}/scratchpad")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"mode\": \"seed\",\n \"expectedEligibilityDigest\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.harmonica.chat/api/v1/sessions/{id}/scratchpad")
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 \"mode\": \"seed\",\n \"expectedEligibilityDigest\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "completed",
"themes": 123,
"participants": 123,
"batches_processed": 123,
"batches_total": 123,
"eligibility_digest": "<string>",
"needs_rebuild": true
}{
"error": {
"code": "validation_error",
"message": "Unknown scratchpad mode"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key"
}
}{
"error": {
"code": "forbidden",
"message": "You don't have access to this session"
}
}{
"error": {
"code": "not_found",
"message": "Session not found"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}Authorizations
Body
Response
Scratchpad result
completed — all messages processed.
partial — a batch failed or processing is incomplete; request continuation explicitly.
no_data — no user messages in session.
busy — another writer owns the current analysis claim.
exists/empty — status mode response.
completed, partial, no_data, busy, exists, empty