curl --request PATCH \
--url https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedRevision": 2,
"edits": [
{
"entryId": "cost-estimate",
"evidenceKind": "estimate",
"reviewStatus": "confirmed",
"dispute": "Another contributor estimates a higher cost; unresolved."
}
],
"approve": true
}
'import requests
url = "https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc"
payload = {
"expectedRevision": 2,
"edits": [
{
"entryId": "cost-estimate",
"evidenceKind": "estimate",
"reviewStatus": "confirmed",
"dispute": "Another contributor estimates a higher cost; unresolved."
}
],
"approve": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: 2,
edits: [
{
entryId: 'cost-estimate',
evidenceKind: 'estimate',
reviewStatus: 'confirmed',
dispute: 'Another contributor estimates a higher cost; unresolved.'
}
],
approve: true
})
};
fetch('https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc', 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/chains/{instanceId}/bmc",
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([
'expectedRevision' => 2,
'edits' => [
[
'entryId' => 'cost-estimate',
'evidenceKind' => 'estimate',
'reviewStatus' => 'confirmed',
'dispute' => 'Another contributor estimates a higher cost; unresolved.'
]
],
'approve' => true
]),
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/chains/{instanceId}/bmc"
payload := strings.NewReader("{\n \"expectedRevision\": 2,\n \"edits\": [\n {\n \"entryId\": \"cost-estimate\",\n \"evidenceKind\": \"estimate\",\n \"reviewStatus\": \"confirmed\",\n \"dispute\": \"Another contributor estimates a higher cost; unresolved.\"\n }\n ],\n \"approve\": true\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expectedRevision\": 2,\n \"edits\": [\n {\n \"entryId\": \"cost-estimate\",\n \"evidenceKind\": \"estimate\",\n \"reviewStatus\": \"confirmed\",\n \"dispute\": \"Another contributor estimates a higher cost; unresolved.\"\n }\n ],\n \"approve\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expectedRevision\": 2,\n \"edits\": [\n {\n \"entryId\": \"cost-estimate\",\n \"evidenceKind\": \"estimate\",\n \"reviewStatus\": \"confirmed\",\n \"dispute\": \"Another contributor estimates a higher cost; unresolved.\"\n }\n ],\n \"approve\": true\n}"
response = http.request(request)
puts response.read_body{
"state": {
"version": 1,
"participantSharingEnabled": true,
"current": {
"id": "<string>",
"number": 2,
"createdAt": "2023-11-07T05:31:56Z",
"models": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"status": "current"
}
],
"entries": [
{
"id": "<string>",
"modelId": "<string>",
"blockId": "key_partnerships",
"label": "<string>",
"detail": "<string>",
"evidenceKind": "unknown",
"reviewStatus": "proposed",
"dispute": "<string>",
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
],
"linkedEntryIds": [
"<string>"
],
"hostFields": [
"blockId"
],
"hostAuthored": true
}
],
"links": [
{
"fromEntryId": "<string>",
"toEntryId": "<string>"
}
],
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
]
},
"revisions": [
{
"id": "<string>",
"number": 2,
"createdAt": "2023-11-07T05:31:56Z",
"models": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"status": "current"
}
],
"entries": [
{
"id": "<string>",
"modelId": "<string>",
"blockId": "key_partnerships",
"label": "<string>",
"detail": "<string>",
"evidenceKind": "unknown",
"reviewStatus": "proposed",
"dispute": "<string>",
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
],
"linkedEntryIds": [
"<string>"
],
"hostFields": [
"blockId"
],
"hostAuthored": true
}
],
"links": [
{
"fromEntryId": "<string>",
"toEntryId": "<string>"
}
],
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
]
}
],
"reviewedRevisionId": "<string>",
"closingRevisionId": "<string>",
"roundBindings": {},
"extractions": {},
"removedEntryIds": [
"<string>"
],
"removedEntryKeys": [
"<string>"
]
},
"canEdit": true,
"canApproveClosing": true,
"sourceStatus": "current",
"management": {
"expectedRevision": 1,
"participantSharingEnabled": true
},
"preparation": [
{
"stepIndex": 1,
"title": "<string>",
"status": "not_prepared",
"canPrepare": true
}
],
"boundSnapshotHeld": true,
"boundSnapshotMessage": "<string>"
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key"
}
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Try again in 30 seconds."
}
}{
"error": "<string>",
"code": "unauthorized"
}Correct, review or control sharing of a Canvas
Requires authenticated workspace editor access plus each source session’s results audience. Participant tokens do not authorize writes. Changes use expectedRevision under the chain lock; stale revisions return bmc_changed. Unknown or duplicate entries, conflicting removals and invalid links are rejected. Additions use an existing model ID and a server-generated entry ID. Edits/removals are protected against later extraction; new conflicting model output remains a proposal. No model call is made by this operation.
approve=true reviews the resulting revision for the next dependent round. closing=true also requires approve=true, a completed chain and a current final extraction. Neither action supplies group agreement or validates estimates. Sharing-only changes can be made before a Canvas exists or when source content is withheld, using management.expectedRevision and edits=[]. Source-dependent edits/approvals require current sources. Turning sharing off denies later participant reads, including the closing Canvas; it does not grant new transcript access. Responses use private, no-store.
curl --request PATCH \
--url https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedRevision": 2,
"edits": [
{
"entryId": "cost-estimate",
"evidenceKind": "estimate",
"reviewStatus": "confirmed",
"dispute": "Another contributor estimates a higher cost; unresolved."
}
],
"approve": true
}
'import requests
url = "https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc"
payload = {
"expectedRevision": 2,
"edits": [
{
"entryId": "cost-estimate",
"evidenceKind": "estimate",
"reviewStatus": "confirmed",
"dispute": "Another contributor estimates a higher cost; unresolved."
}
],
"approve": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: 2,
edits: [
{
entryId: 'cost-estimate',
evidenceKind: 'estimate',
reviewStatus: 'confirmed',
dispute: 'Another contributor estimates a higher cost; unresolved.'
}
],
approve: true
})
};
fetch('https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc', 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/chains/{instanceId}/bmc",
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([
'expectedRevision' => 2,
'edits' => [
[
'entryId' => 'cost-estimate',
'evidenceKind' => 'estimate',
'reviewStatus' => 'confirmed',
'dispute' => 'Another contributor estimates a higher cost; unresolved.'
]
],
'approve' => true
]),
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/chains/{instanceId}/bmc"
payload := strings.NewReader("{\n \"expectedRevision\": 2,\n \"edits\": [\n {\n \"entryId\": \"cost-estimate\",\n \"evidenceKind\": \"estimate\",\n \"reviewStatus\": \"confirmed\",\n \"dispute\": \"Another contributor estimates a higher cost; unresolved.\"\n }\n ],\n \"approve\": true\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expectedRevision\": 2,\n \"edits\": [\n {\n \"entryId\": \"cost-estimate\",\n \"evidenceKind\": \"estimate\",\n \"reviewStatus\": \"confirmed\",\n \"dispute\": \"Another contributor estimates a higher cost; unresolved.\"\n }\n ],\n \"approve\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expectedRevision\": 2,\n \"edits\": [\n {\n \"entryId\": \"cost-estimate\",\n \"evidenceKind\": \"estimate\",\n \"reviewStatus\": \"confirmed\",\n \"dispute\": \"Another contributor estimates a higher cost; unresolved.\"\n }\n ],\n \"approve\": true\n}"
response = http.request(request)
puts response.read_body{
"state": {
"version": 1,
"participantSharingEnabled": true,
"current": {
"id": "<string>",
"number": 2,
"createdAt": "2023-11-07T05:31:56Z",
"models": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"status": "current"
}
],
"entries": [
{
"id": "<string>",
"modelId": "<string>",
"blockId": "key_partnerships",
"label": "<string>",
"detail": "<string>",
"evidenceKind": "unknown",
"reviewStatus": "proposed",
"dispute": "<string>",
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
],
"linkedEntryIds": [
"<string>"
],
"hostFields": [
"blockId"
],
"hostAuthored": true
}
],
"links": [
{
"fromEntryId": "<string>",
"toEntryId": "<string>"
}
],
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
]
},
"revisions": [
{
"id": "<string>",
"number": 2,
"createdAt": "2023-11-07T05:31:56Z",
"models": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"status": "current"
}
],
"entries": [
{
"id": "<string>",
"modelId": "<string>",
"blockId": "key_partnerships",
"label": "<string>",
"detail": "<string>",
"evidenceKind": "unknown",
"reviewStatus": "proposed",
"dispute": "<string>",
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
],
"linkedEntryIds": [
"<string>"
],
"hostFields": [
"blockId"
],
"hostAuthored": true
}
],
"links": [
{
"fromEntryId": "<string>",
"toEntryId": "<string>"
}
],
"sourceRefs": [
{
"kind": "group_summary",
"stepId": "<string>",
"stepIndex": 1,
"sessionId": "<string>",
"summaryDigest": "<string>"
}
]
}
],
"reviewedRevisionId": "<string>",
"closingRevisionId": "<string>",
"roundBindings": {},
"extractions": {},
"removedEntryIds": [
"<string>"
],
"removedEntryKeys": [
"<string>"
]
},
"canEdit": true,
"canApproveClosing": true,
"sourceStatus": "current",
"management": {
"expectedRevision": 1,
"participantSharingEnabled": true
},
"preparation": [
{
"stepIndex": 1,
"title": "<string>",
"status": "not_prepared",
"canPrepare": true
}
],
"boundSnapshotHeld": true,
"boundSnapshotMessage": "<string>"
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key"
}
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": "<string>",
"code": "unauthorized"
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Try again in 30 seconds."
}
}{
"error": "<string>",
"code": "unauthorized"
}Authorizations
Path Parameters
Body
Response
Updated management state and preparation/review eligibility.