Skip to content

Configuration

All routes require the bearer token. The supplied client reads the access file and does not print it.

Where things live

Item What it is
127.0.0.1:8123 JSON API. No browser UI.
/home/ubuntu/.config/sushi/langgraph/access.json Bearer token. Mode 0600, owner ubuntu.
/etc/langgraph/provider.json base_url, model, api_key. Mode 0640, root:ubuntu.
/home/ubuntu/langgraph-data Checkpoints, CSVs, receipts, and results. Mode 0700.
/home/ubuntu/langgraph-results Demo readbacks. Mode 0700.
/opt/langgraph/workflow.py The supplied workflow. Review it before you change the tool.

Routes

Call Body
GET /health Service readiness
POST /runs run_id and values
GET /runs/ID The checkpoint
POST /runs/ID/approve Boolean approved
POST /runs/ID/retry An empty JSON object

Use Content-Type: application/json. The API handles one request at a time.

Provider contract

response_format is {"type": "json_object"}. The model must return exactly action = publish_report and run_id equal to the workflow id. Anything else is an invalid proposal and becomes a failed node (HTTP 503) that you can retry. A retry of the proposal node does not rerun the calculator.

The unique local SQLite action record stops a replayed publication from appending a second action. That protection applies to the supplied report publisher.

Last updated November 11, 2026 · Suggest an improvement