budget

Declare spending intent

Declare intent to spend. If within budget, records spend immediately and returns completed status. If over budget and on_limit=approve, creates an approval request (202). If over budget and on_limit=reject, returns 402.

post/v1/charge

Request

  • Base URL: https://agentlair.dev
  • URL: https://agentlair.dev/v1/charge
  • Auth: HTTP bearer

Request body

amountinteger required

Amount in atomic USDC units (1,000,000 = 1.00 USDC)

categorystring

Spend category

descriptionstring

Human-readable description

reference_idstring

External reference ID

metadataobject

Arbitrary metadata stored with approval request

Response

Charge completed (within budget)

Changes

No recorded changes to this operation across all 1 revision of this API.