Deploy and Host Budget Balance API on Railway

Subtract committed amounts from a budget.

About Hosting Budget Balance API

This is a stateless JSON tool. Deploy it, copy TOOL_TOKEN from service variables and send it as an Authorization: Bearer header on POST /run. The /health endpoint is public and returns readiness only. Inputs are limited to 64 KiB. The application does not store requests or call a model.

Why Deploy Budget Balance API

Call a deterministic operation from an agent, workflow or application without an LLM API key.

Common Use Cases

Subtract committed amounts from a budget.
Insert a deterministic check or transformation in a workflow.
Repeat the documented example in a regression check.

Dependencies for Budget Balance API

Python 3.13 container and a Railway project.
An HTTP client with your generated bearer token.

Example input for POST /run

{"budget_minor": 100, "commitments_minor": [20, 25]}

Expected response

{"result": 55}

The single process is intended for small internal workloads. Set concurrency and load limits upstream before serving high volume traffic.