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).

OperationCall
List site dataGET /sites/{siteId}/dataFree
List site documentsGET /sites/{siteId}/documentsFree
Save data blockPOST /sites/{siteId}/dataFree
Delete data blockDELETE /sites/{siteId}/data/{blockId}Free

List site data

GET/sites/{siteId}/dataFree

The data blocks saved on the site: charts, KPI grids and site maps kept from conversations.

MCP tool list_site_data

ArgumentTypeDescription
siteIdin the pathstringIts id.
Request
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…"
Response · 200
{
  "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

GET/sites/{siteId}/documentsFree

The documents written for the site (articles, briefs…).

MCP tool list_site_documents

ArgumentTypeDescription
siteIdin the pathstringIts id.
Request
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
  -H "Authorization: Bearer sk_live_…"

Answers 200 with { "data": … }.

Save data block

POST/sites/{siteId}/dataFree

Save a chart or a KPI grid on the site (as the app’s Save on a conversation’s chart).

MCP tool save_data_block

ArgumentTypeDescription
siteIdin the pathstringIts id.
typerequiredstringchart or kpi_grid.chart | kpi_grid
titlerequiredstring1–500 characters
datarequiredobjectThe chart’s or KPI grid’s props, as a conversation’s block carries them.
conversation_idoptionalstringThe conversation it comes from.at least 1 character
message_idoptionalstringThe message it comes from: a message saves one block per title (409 CONFLICT).at least 1 character
Request
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

DELETE/sites/{siteId}/data/{blockId}Free

Delete a data block saved on the site.

MCP tool delete_data_block

ArgumentTypeDescription
siteIdin the pathstringIts id.
blockIdin the pathstringIts id.
Request
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.

Ready to get your site off the ground?

Ask your first question - semchat replies with a clear action plan in seconds.

Free · no sign-up · takes 5 seconds