budget

WRITE: add one line to the trip budget the traveller typed themselves (source 'user' — never deleted by a budget reset,

WRITE: add one line to the trip budget the traveller typed themselves (source 'user' — never deleted by a budget reset, never overwritten by seeding). Give an estimated amount, an actual amount, or both. Category is one of: flights | accommodation | food | transport | activities | shopping | other. Currency is a 3-letter code; if it has no FX rate the line still stores honestly and is reported as excluded from converted totals.

post/actions/add_budget_expense

Request

  • Base URL: https://findinghorizons.ca/api/v1
  • URL: https://findinghorizons.ca/api/v1/actions/add_budget_expense
  • Auth: OAuth 2 (authorization code, authorization URL https://findinghorizons.ca/api/mcp/authorize, token URL https://findinghorizons.ca/api/mcp/oauth/token, scopes: budget:write)

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

tripIdstring required
labelstring required

What the money was/is for

categorystring

flights | accommodation | food | transport | activities | shopping | other

estimatednumber

Planned amount

actualnumber

Amount actually spent

currencystring

3-letter code, e.g. JPY. Defaults to the budget currency.

notesstring
todaystring

The traveller's own date, YYYY-MM-DD, where the action needs one

expectedVersioninteger

For a change to a trip: the planVersion you last read

Response

Done — { ok, api, action, result, card, operation? }

Changes

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