API reference

Analysis lives behind a single endpoint. You can call it directly to integrate Weftmap into your own tooling.

POST /api/analyze

Send code and receive a { nodes, edges } graph. Accepts a snippet or multiple files.

POST /api/analyze
Content-Type: application/json

{
  "language": "python",
  "code": "def main():\n    helper()\n\ndef helper():\n    pass"
}

{
  "language": "python",
  "files": [
    { "path": "main.py", "content": "from util import work\n..." },
    { "path": "util.py", "content": "def work(): ..." }
  ]
}

{
  "nodes": [
    { "id": "main.py::main", "label": "main", "type": "function", "parent": "mod::main.py" }
  ],
  "edges": [
    { "source": "main.py::main", "target": "util.py::work", "kind": "calls" }
  ]
}

Fields

• language — one of the supported languages (python, javascript, typescript, go, rust, sql).
• code — the snippet to analyze (snippet mode).
• files — an array of { path, content } (project mode). When present, it takes precedence over code.

Limits

• Up to 2 MB of total content per request.
• Up to 400 files in project mode.

Errors

• 400 — invalid JSON or unsupported language.
• 413 — size or file-count limit exceeded.