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

OperationCall
List todosGET /sites/{siteId}/todosFree
Create todoPOST /sites/{siteId}/todosFree
Update todoPATCH /sites/{siteId}/todos/{todoId}Free
Delete todoDELETE /sites/{siteId}/todos/{todoId}Free

List todos

GET/sites/{siteId}/todosFree

The site’s action plan.

MCP tool list_todos

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

POST/sites/{siteId}/todosFree

Add 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

ArgumentTypeDescription
siteIdin the pathstringIts id.
titlerequiredstringWhat to do.1–500 characters
descriptionoptionalstringup to 4000 characters
priorityoptionalstringhigh, medium (default) or low.high | medium | low
categoryoptionalstringThe plan pillar it belongs to. Default technical.technical | content | accessibility | backlinks | competitors
source_langoptionalstringThe language the text is written in (e.g. "fr", "en"). Omitted: the site’s content language.2–5 characters
Request
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'
Response · 201
{
  "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

PATCH/sites/{siteId}/todos/{todoId}Free

Change 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

ArgumentTypeDescription
siteIdin the pathstringIts id.
todoIdin the pathstringIts id.
statusoptionalstringa_faire (to do), en_cours (in progress), fait (done) or ignore (ignored).a_faire | en_cours | fait | ignore
titleoptionalstring1–500 characters
descriptionoptionalstring | null
priorityoptionalstringhigh | medium | low
source_langoptionalstringThe language of the new title / description. Ignored when neither changes.2–5 characters
Request
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

DELETE/sites/{siteId}/todos/{todoId}Free

Remove a task from the action plan.

MCP tool delete_todo

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

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