System Atlas

review_drafts

Decide on drafts by id (component ids act on the component and its draft values; value ids on one value; contribution ids accept or reject a contribution). confirm keeps it, reject removes it, private keeps it for this workspace only (off every public page). Ids the key cannot see are skipped. Needs an editor key; contributions need the company owner's key.

Write · editor keyMCP tool

Parameters

  • workspacestringrequired

    Workspace slug

    min 1 char
  • idsstring[]required

    Draft component ids, draft value ids or contribution ids from list_drafts

    min 1 itemmax 500 items
  • actionenumrequired
    confirmrejectprivate

Example call

Agents call tools by name; you rarely write this by hand. It is here so you can test the server from a shell or your own code.

{
  "name": "review_drafts",
  "arguments": {
    "workspace": "acme-builders",
    "ids": [
      "3f1c2a4e-1b7d-4c55-9a8e-3d2f6b1c0e91"
    ],
    "action": "confirm"
  }
}

Response

The result is one text content block holding this JSON (abbreviated here). Errors come back with isError: true and a message such as Error 401: … or Invalid input: ….

Response
{
  "done": 1,
  "skipped": 0
}

Over REST

The same call without MCP: POST/api/v1/workspaces/:slug/drafts/review