Learning Map API

Authentication

Mint a key in the dashboard Integrations tab. Bearer endpoints require an active API Metered plan. Cookie dashboard and in-app sessions do not.

Authorization: Bearer sk_…
Content-Type: application/json

Each key is a single full-access token. MCP uses the same key on POST /api/mcp.

Rate limits

120 requests per minute per key. Exceeded returns 429 rate_limit_exceeded.

What you can create

• Learning Maps — /api/v3/workspaces. REST paths still say workspaces; the product name is Learning Map.
• Flows — independent Solve, Calibration, and Verification at /api/v3/flows. Optional workspace_id when created from a map. link_flow places an existing flow on a tile.

POST /api/v3/flows
{
  "kind": "solve",
  "name": "Linear systems",
  "topic": "Solve Ax = b"
}

Endpoint index

MCP tools/list is 1:1 with these REST twins.

• GET /api/v3/workspaceslist_workspaces

  List Learning workspaces accessible to this key.

• GET /api/v3/workspaces/{workspace_id}get_workspace

  Read workspace metadata, kind, map summary, and workspace settings.

• POST /api/v3/workspacescreate_workspace

  Create a Learning Map only, including an optional map and settings. Solve, Calibration, and Verification use create_flow.

• PATCH /api/v3/workspaces/{workspace_id}update_workspace

  Edit workspace settings, contents, and map blocks for a Learning workspace.

• GET /api/v3/workspaces/{workspace_id}/blockslist_blocks

  List map blocks / contents for a workspace.

• PATCH /api/v3/workspaces/{workspace_id}/blocksupdate_blocks

  Replace or patch the workspace map (blocks and links).

• GET /api/v3/workspaces/{workspace_id}/map-toolslist_map_tools

  List Helios Learning Map builder tools (topologies, unusable ground, generative effects, DAG, edit/delete, overlay notes and drawing layers) and the current map snapshot.

• POST /api/v3/workspaces/{workspace_id}/map-toolsapply_map_tool

  Apply one or more Helios Learning Map builder tools atomically (same catalog as in-app Helios). Learning workspaces only.

• GET /api/v3/workspaces/{workspace_id}/settingsget_workspace_settings

  Read Learning Map settings (title, visibility).

• PATCH /api/v3/workspaces/{workspace_id}/settingsupdate_workspace_settings

  Patch Learning Map settings.

• GET /api/v3/flowslist_flows

  List Solve, Calibration, and Verification flows owned by this key. Optional workspace_id filters to one Learning Map.

• POST /api/v3/flowscreate_flow

  Create a Solve, Calibration, or Verification flow. Independent unless workspace_id is set.

• GET /api/v3/flows/{flow_id}get_flow

  Read one Solve, Calibration, or Verification flow.

• PATCH /api/v3/flows/{flow_id}update_flow

  Update a Solve, Calibration, or Verification flow.

• DELETE /api/v3/flows/{flow_id}delete_flow

  Delete a Solve, Calibration, or Verification flow.

• POST /api/v3/flows/{flow_id}/linklink_flow

  Place or link a Solve, Calibration, or Verification flow onto a Learning Map tile.

MCP

POST /api/mcp
Authorization: Bearer sk_…
{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Partner loop: create_workspace or get_workspace, then list_map_tools / apply_map_tool, then create_flow → link_flow. Nested /api/v3/workspaces/{id}/flows still creates a flow on that map.

Do not call start_session, upload_proof_of_work, or end_session. Those tools are not on the public catalog. Static skill: /skill.md.