curl --request GET \
--url https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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 => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc")
.header("Authorization", "Bearer <token>")
.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::Get.new(url)
request["Authorization"] = 'Bearer <token>'
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": "<string>",
"code": "unauthorized"
}{
"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"
}Read a chain's Business Model Canvas
Reads only; never generates a Canvas. All responses use private, no-store. Authenticated accounts (API key or browser session) need workspace viewer access and access to the results audience of every source session. A host-only source requires owner/admin access to that source; a workspace editor role alone does not override the source’s audience.
Alternatively, pass the signed invitation identity in x-chain-participant-token and select stepIndex or closing=true. The server rechecks membership in this chain, withdrawal, participant sharing and the requested round. Review rounds need an eligible assignment, cannot be in the future, and return their immutable bound revision. Closing reads need a completed chain and an approved closing revision. A valid token plus a round/closing selector requests the participant projection even when the caller is also signed in. It grants no workspace role, candidate history, original-contribution access or arbitrary revision selection.
Source changes may withhold state on management reads while preserving recovery controls; stale participant snapshots fail closed. Review and evidence status remain distinct. A filled Canvas is not proof of agreement, market demand or viability. Rendered/exported adaptations retain visible Strategyzer.com credit and the original/adaptation license notices.
curl --request GET \
--url https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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 => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.harmonica.chat/api/v1/chains/{instanceId}/bmc")
.header("Authorization", "Bearer <token>")
.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::Get.new(url)
request["Authorization"] = 'Bearer <token>'
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": "<string>",
"code": "unauthorized"
}{
"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
Query Parameters
Response
Authorized management state or one participant-bound revision.