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