DocumentationAPI reference
Action plan
A site’s action plan: list, add, change and delete its tasks.
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 todos | GET /sites/{siteId}/todos | Free |
| Create todo | POST /sites/{siteId}/todos | Free |
| Update todo | PATCH /sites/{siteId}/todos/{todoId} | Free |
| Delete todo | DELETE /sites/{siteId}/todos/{todoId} | Free |
List todos
/sites/{siteId}/todosFreeThe site’s action plan.
MCP tool list_todos
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15ea4-c1e0-7c64-bc14-c499bd6f1b83",
"title": "Corriger le point technical n°1",
"description": "Corriger le point technical n°1 - détail.",
"category": "technical",
"priority": "high",
"status": "a_faire",
"source": "audit_auto",
"created_at": "2026-10-21T13:26:58.000Z"
},
{
"id": "01a15ea4-c1e0-74b9-8ca0-f4c3410b0f0f",
"title": "Corriger le point technical n°2",
"description": "Corriger le point technical n°2 - détail.",
"category": "technical",
"priority": "medium",
"status": "fait",
"source": "audit_auto",
"created_at": "2026-10-21T13:27:58.000Z"
}
]
}Create todo
/sites/{siteId}/todosFreeAdd a task to the site’s action plan.
- Added as a manual task (source manuel), to do (status a_faire). Answers the task.
MCP tool create_todo
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
titlerequired | string | What to do.1–500 characters |
descriptionoptional | string | up to 4000 characters |
priorityoptional | string | high, medium (default) or low.high | medium | low |
categoryoptional | string | The plan pillar it belongs to. Default technical.technical | content | accessibility | backlinks | competitors |
source_langoptional | string | The language the text is written in (e.g. "fr", "en"). Omitted: the site’s content language.2–5 characters |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'{
"data": {
"id": "01a168f1-9dac-7584-b809-fc4ed6d1cffe",
"title": "Add alt text to the gallery images",
"description": null,
"category": "technical",
"priority": "high",
"status": "a_faire",
"source": "manuel",
"created_at": "2026-10-23T13:27:07.000Z"
}
}Update todo
/sites/{siteId}/todos/{todoId}FreeChange a task of the action plan: its status (to do, in progress, done, ignored), title, description or priority.
- Answers the task as it now is.
- Text is returned as stored, in the language it was written in (source_lang; null = the site’s content language). The app translates it on display; the API does not.
MCP tool update_todo
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
todoIdin the path | string | Its id. |
statusoptional | string | a_faire (to do), en_cours (in progress), fait (done) or ignore (ignored).a_faire | en_cours | fait | ignore |
titleoptional | string | 1–500 characters |
descriptionoptional | string | null | |
priorityoptional | string | high | medium | low |
source_langoptional | string | The language of the new title / description. Ignored when neither changes.2–5 characters |
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"status": "a_faire"}'Answers 200 with { "data": … }.
Delete todo
/sites/{siteId}/todos/{todoId}FreeRemove a task from the action plan.
MCP tool delete_todo
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
todoIdin the path | string | Its id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
-H "Authorization: Bearer sk_live_…"Answers 204 with { "data": … }.
A question this doesn’t answer? Write to us.

