DocumentationAPI reference
Data and documents
A site’s saved charts, KPI grids and documents.
Every operation below is also an MCP tool, under the same name. Free operations cost nothing; Billed ones use the workspace’s credits, as in the app (What it costs).
| Operation | Call | |
|---|---|---|
| List site data | GET /sites/{siteId}/data | Free |
| List site documents | GET /sites/{siteId}/documents | Free |
| Save data block | POST /sites/{siteId}/data | Free |
| Delete data block | DELETE /sites/{siteId}/data/{blockId} | Free |
List site data
/sites/{siteId}/dataFreeThe data blocks saved on the site: charts, KPI grids and site maps kept from conversations.
MCP tool list_site_data
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15ea4-c1e0-7157-becb-0b33c960722e",
"type": "kpi_grid",
"title": "Vue d'ensemble - alpha",
"data": {
"title": "Vue d'ensemble - alpha",
"cards": [
"…",
"…"
]
},
"conversation_id": "01a1597c-9120-70b0-87de-f58bf6fe953e",
"created_at": "2026-10-18T13:26:58.000Z"
},
{
"id": "01a15ea4-c1e0-730a-a3c7-1cf43b1cd203",
"type": "chart",
"title": "Trafic organique - alpha vs concurrents",
"data": {
"title": "Trafic organique - alpha vs concurrents",
"type": "bar",
"x_key": "domain",
"y_keys": [
"trafic"
],
"data": [
"…",
"…"
],
"format": "number",
"unit": "visites/mois"
},
"conversation_id": "01a15456-3520-7443-9b04-564ff63c5448",
"created_at": "2026-10-17T13:26:58.000Z"
}
]
}List site documents
/sites/{siteId}/documentsFreeThe documents written for the site (articles, briefs…).
MCP tool list_site_documents
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
-H "Authorization: Bearer sk_live_…"Answers 200 with { "data": … }.
Save data block
/sites/{siteId}/dataFreeSave a chart or a KPI grid on the site (as the app’s Save on a conversation’s chart).
MCP tool save_data_block
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
typerequired | string | chart or kpi_grid.chart | kpi_grid |
titlerequired | string | 1–500 characters |
datarequired | object | The chart’s or KPI grid’s props, as a conversation’s block carries them. |
conversation_idoptional | string | The conversation it comes from.at least 1 character |
message_idoptional | string | The message it comes from: a message saves one block per title (409 CONFLICT).at least 1 character |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/data \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"type": "chart", "title": "…", "data": {}}'Answers 201 with { "data": … }.
Delete data block
/sites/{siteId}/data/{blockId}FreeDelete a data block saved on the site.
MCP tool delete_data_block
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
blockIdin the path | string | Its id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/data/{blockId} \
-H "Authorization: Bearer sk_live_…"Answers 204 with { "data": … }.
A question this doesn’t answer? Write to us.

