chapters

Save a place to the traveller's Next Chapter: a country (name or ISO-2), optionally a city, and optionally one tag: Next

Save a place to the traveller's Next Chapter: a country (name or ISO-2), optionally a city, and optionally one tag: Next trip, Potential relocation, Nomad route, Retirement dream, Someday. Saving one that is already there just updates its tag. (Removing is done in the app.)

post/actions/save_future_chapter

Request

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

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

countrystring required
citystring
tag'Next trip' | 'Potential relocation' | 'Nomad route' | 'Retirement dream' | 'Someday'
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.