Set the budget before the agent starts.

teleon.dev/docs/fees locks a spending ceiling before unattended work begins, pauses at checkpoints, clears fees and royalties when work completes, and waives fees for public-good work.

teleon.dev/docs/feesFee clearinghousehttpsjson

Read the docs Copy the agent prompt

Tonight's run

Budget ceiling500 cents

checkpoint 1checkpoint 2

Spent so far210 cents

Held for the next steps140 cents

Released at settlement150 cents

The run paused at checkpoint 1 for review, then continued; unused budget returns at settlement.

What it does

Hold before you run

A budget hold reserves the most a run may spend.

Checkpoints

Runs pause at checkpoints so you can review before more spend.

Public-good waivers

Work for open causes runs with its fees waived.

The contract

A hold names the ceiling, the checkpoints and the account; settlement releases what was unused.

HoldsCeiling locked before the first step

CheckpointsPause and review points

WaiversFor public-good work

AccessRING-2

Identifiers

teleon_agent_fee_hold/v1
q12_royalty_split_bps

Execution contracts

Pre-execution AFK budget holds and fee clearinghouse

Request and responseCopy

POST /v1/holds
{
  "run": "overnight_2026_10_25",
  "ceiling_cents": 500,
  "checkpoints": [150, 300]
}

# Response
{
  "hold": "hd_441",
  "status": "held",
  "released_at_settlement": true
}

Endpoints

Method	Path	Access	What it does
`POST`	`/v1/holds`	RING-2	Place a budget hold before a run
`POST`	`/v1/holds/{id}/continue`	RING-2	Continue past a checkpoint
`POST`	`/v1/holds/{id}/settle`	RING-2	Settle and release the rest

Listed paths appear in the service’s published files today. In the one-host plan every path here is served under api.teleon.dev/v1/fees.

How it connects

Reads from

Identity and ringsteleon.dev/docs/auth

Feeds into

Royalty ledgerteleon.dev/docs/ledger Workersteleon.dev/docs/workers Harness switchboardteleon.dev/docs/switchboard

Queuesaq25 aq24

StoresS26 Tenant Vault, Scoped Grants and 8 Fiduciary Gates

For agents

Give your agent the read-only guide first. It reports back before any write.

Agent prompt

Read https://teleon.dev/docs/fees.md and explain how a budget hold works. Read only: ask me before placing a hold.

Copy

llms.txt Agent card

Words on this page

Full glossary

Royalty split: The share of credit or payment each contributor earns, written in basis points (1 bp is 0.01 percent).
Fiduciary gate: A check that guards money, secrets or trust before work is accepted.